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Foreword 



It is less than 10 years since the VisiCak spreadsheet program changed 
the face of microcomputing. Small computers had untU men been little 
more than art expensive curiosity, hut VisiCalc's arrival in 1979 proved 
that real work could be done on a humble Apple 11. Now -very micro 
worth I he name has a spreadsheet application, even the calculator- 
sized Psion Organiser Given their facility for repetitive jobs, it was 
inevitable that micros would take on the task of filing ton. It's dignified 
with the name database managements and the files are kepi on (loppy 
disc rather than in big cabinets. 

These days, a credible BBC micro system can be set up at about a third of 
the cost of the machine back in 19BZ Add VIEW, ViewSheet arid 
View6ton? and the result is a professional business tool, yet not too 
complicated to be mastered either at home nr in school. The Acomsoft 
view family has been vciy important for the BBC micro, though it hasn't 
been without competitors Computer Concepts has gathered a large 
base of users for irs Word wise word processor and the Inter family, and 
BBC Soft's Ultra Calc spreadsheet is similar in capability to VlewSheet. 
At the time of writing, Computer Concepts has fust completed its family 
with tlu j release of InterBase. However, until recently only Acomsoft 
could offer the complete set of productivity software—word processor, 
spreadsheet and database manager. 

This book and its companion volume VIEW: A Dahhand Guide by Bruce 
Smith, aim to help you get the most from this family of software. 
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1: An Introduction to the View 
Family 



The VIEW Family 

When a new microcomputer is launched, its success depends upon (he 
software which goes with it In designing the original bbC model A 
microcomputer, attention was pa id in the needs of software other than 
basic programs and the inevitable video games, so that the machine 
would be suitable for as wide a range of applications as possible. 
Perhaps the most obvious outward sign of this was the inclusion of a 
TAB key on the keyboard: there is little need for it except in 
word processing. The first extra sideways ROM released for the new 
machine was a wordproccssor Although not the first, Acomsoft's view 
worrfprocessnr in its original form was one of the most popular 
sideways ROMs for the BBC micro. 

The first VTEW was joined by V iewSheet, a spreadsheet, and then 
VlewStore, a powerful but complex database manager. The 
wordprotessor, spreadsheet and database manager form the working 
core of any business software family. 

Aeornsoft has since released several revised versions of viewi 2d and 
the current standard 3.0 (versions of this are included with the Master 
series micros). Other recent additions to the family include Viewlndex, 
an indexing program, ViewSpell, a spelling checker, and ViewPlot 
which enables graphs and diagrams to be prepared. 

The popularity of the view family has been enhanced by the inclusion of 
both VIEW ant! ViewSheet as standard in the BBC Master series micros. 
However, the UK version of the Master Compact contains only the 
wordprocessor The others can be added to any BBC micro, by plugging 
in the appropriate sideways ROMS. Disc versions of Vie wind ex and 
ViewPlot are also available and some of the family are still sold for the 
Acorn Electron, in cartridge form. 

An important new development for the Master series micro is 
OverView. As its name suggests, this is a kind of family manager; it 
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allows rapid switching between each VIEW application. On leaving one 
application, it retains the current work, Next time that application is 
entered, the work formerly in progress is restored. OverView is only 
available in a Master cartridge,, or on disc for the Master Compact, but 
provides Master series owners with the whole view family in a single 
package. 

This use of software from the same family is better than using programs 
from several different sources for two reasons. First, they all look 
similar on screen, have many commands in common, and use some 
function keys in the same way. Learning to use the applications is 
therefore simpler. Second, it is often easier to exchange data between 
members of the same family than between two unrelated applications. 

Without OverView, the sharing of data is not really a strong feature of 
the view family. Transfers carit be made directly between modules, or 
bv sharing files in the manner used by more integrated programs, but 
there are ways that material can be moved between VIEW and 
VieWStore, from ViewStOre to ViewSheet and from ViewSheet to 
view. All three of these packages can be used to provide data for 
View Plot. These data sharing abilities are summarised in figure 1.1 



Figure 1.1. OverView Data Sharing 


This book provides the novice with an Introductory guide to the use of 
ViewSheet and ViewStore. Later chapters give experienced users an 
insight into more complex features ViewPlot is also explained. 

All details relating to ViewStore and ViewSheet are also applicable to 
OverView on the Master series micros and additional OverView 
features are discussed. 
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The ViewSheel Spreadsheet 

Spreadsheets like ViewSheet are useful for repetitive numerical work. 
In business, this includes costing exercises, sales analyses or forecasts, 
and fin and a! planning. At home, budgeting can be made easier, A 
spreadsheet can be used to work out interest problems with mortgages 
and loans As spreadsheets are common business tools, learning hoiv to 
use them is .1 valuable exercise at school. It can also be used Like a 
calculator W hen d on e by hand, steitistica I work is notoriously 
repetitive, but a spreadsheet makes life much simpler, It helps to collate 
numerical information, and can be used to derive many statistical 
descriptions like mean and standard deviation, 

AH these types of exercise can be done on paper, and with the help of a 
calculator they might not seem too daunting. So why use a 
spreadsheet? If a paper calculation is worked out for mortgage 
repayments, what do you do w hen the interest rate changes? If a 
mistake is discovered in the data used to work out a standard deviation, 
what do you do? How can the effect of s change in the price of raw 
materials upon overall product costs be investigated? This means 
working out ill your calculations again - a very lime-consuming task 
With a spreadsheet r all you do fs press a few buttons, and the answer is 
there in seconds. 

This feature makes the spreadsheet the powerful business tool it is. It 
allows experimentation with figures, llow much would reducing stock 
le vels in the slack months save? Alter a few figures, and the revised 
costing appears instantly , 

The ViewStore Database Manager 

A database is a store of organised Informations domestic examples 
include card indexes and address books. At its simplest level, ViewStore 
can be used to keep the electronic equivalent of a card index. The 
information on the electronic cards can be almost anything; a telephone 
list; a set of references to magazine articles; a list of books, stock parts 
or business transactions with information on each item. Any particular 
ViewStore card can be found very quickly, and the mformation shown 
on screen or printed out. 
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Unlike a trad it ion a L database, the electronic cards don't have to be kepi 
in one set order. A telephone directory is sorted in order of surname, &o 
it can only bo used by knowing the name of the person. Computer- 
based data can be sorted into several different orders, so a person's 
name could be found by lowing only their telephone number or their 
address. 

Complex questions can be answered quickly from on electronic 
database. How many people cm the list live in Milton Keynes? Ls there 
a reference to the word 'granite' in the title of any books m the library? 
What is the tola] wholesale value of the stock of windscreen wipers? 
Searching for this type of information is often too time-consuming to Lie 
worthwhile with card indexes. The computer makes the same 
information easily accessible. 

There is a penalty to pay; the electronic database is more complex than 
a simple Index or phone book- Thought has to be put into the database 
design before anything is typed in. There is no electronic equivalent of 
scribbling extra notes on the corner of a traditional piece of card? 

Graphics with ViewPlot 

ViewPlot is intimately related to both the database manager and the 
spreadsheet modules of the view family, It is a charting utility to 
present numerical data and results from both of the other packages in 
graphical form. 

OverView Goodies 

OverView provides a convenient and cost-effective way of adding the 
remainder of the view family to the applications already provided with 
the Master 12B. In addition to the usual features, OverView adds a few 
new commands to the Master series, For example, you can have a 
10^-character wide screen, which is a boon on large spreadsheets. 

Other commands simplify data transfer into View5heet r and allow 
temporary switching front one language to anolher without having to 
keep saving and reloading time and time again. On-screen help for the 
whole family is also included. 
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Compatibility 

The members of the view family work with all BT5C micros fitted with 
operating system (OS) version 12 or later* They .ire compatible with the 
various Acorn Disc Filing Systems (DF5), and with the Advanced Disc 
Filing System (ADFSk The Econet network, the Network Filing System 
(N>s) and Advanced Network Filing System (anfs> arc also compatible 
OverView' requires a Master 12B micro. 

A fast filing system is necessary to get Lhe best out of any of these 
applications. ViewShcet can also use cassettes for file storage, but 
using cassettes makes loading and saving slow and some spreadsheet 
features can't be used. 

Using ViewStore or ViewFlot with pra 0.9 isn't rapiunended, as it can 
result in the corruption of the disc catalogue. Fitting pfb 1.2 or a later 
version is required. If using ViewStore on a network, an upgrade to 
ANE5 speeds up operations. 

Type Conventions Used 

In this book, various signs arc used ill the following way : 

KEY This denotes a single key on the keyboard, for example 

ESCAPE, UP Is the grey up-cursor key (also DOWN, LEFT 
and RIGHT). Similarly, to is the first red function key 
Function keys may also be indicated by the relevant 
command; these are marked cm the narrow black function 
key strips- RETURN is used to indicate pressing the return 
key, but only where it is unexpected. It often needs to be 
pressed at the end of a line of input even where not 
marked, 

CTRL*® All keys can be used in conjunction with SHIFT and CTRL, 
for example CTRL-® or SHIFT-CQRY. This means hold 
down the SHIFT key, briefly press the COPY key and then 
release the SHIFT key. 

Means ‘filer must be replaced by something appropriate 
according to the context eg, a file name. 
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[200] Shows '200' is option a] (this also appears as !<file2>L 

which means that an appropriate filename is optional), 

Bytes fr*e This typeface distinguishes computer text* often something 
that is displayed on screen or printed out. 

ned* 3 Denotes some text that should be typed at the keyboard, 
usually a command. 


Throughout this book, some familiarity with a nac’ micro is assumed, 
but no previous knowledge of ViewStore, ViewSheet or ViewFloi is 
needed. Experience of the VIEW word processor is an advantage but 
not absolutely necessary. 


2 ; Beginning With Viewsheel 



Spreadsheet software has been an important driving force in the 
development of the microcomputer market The first micro-based 
spreadsheet,. Visicnrp's Vfskale, enabled Ihe original Apple EJ computer 
to become the first real business machine, though it had less impact in 
Europe than in North America. Similarly, the release of Lotus 1-2-3 
added e\tra impetus to the bandwagon after the introduction of the 
jrm PC in 1931. Although l otus 1-2 -3 is an integrated package covering 
database management and business graphics, its huge popularity is 
founded upon the capability of its spreadsheet, 

ViewSheet has not had such a catalytic role to play in the BBC micro 
market. The Acorn machines wen? already well established before its 
release, especially in the educational sector. However, the 
development of spreadsheet applications such as ViewSheet, has been 
vital in attracting business users to the BBC micro. 

ViewSheel ls a typical general purpose spreadsheet for a micro, and 
compares favourably with others used on the BBC micro. The principles 
learned using ViewSheet can be easily applied to other spreadsheet 
programs for the BBC micro and other computers. 

A First Look 

This section introduces the fundamental features of ViewSheet, and 
describes the construction of a simple spreadsheet. 

Starting Up ViewSheet 

The ViewSheet application is normally available as a 28-pin ROM to be 
Installed in one of the sideways HOM sockets in the computer. Simple 
instructions for doing this come with the ROM. The key strip should also 
be put above the function keys With the Master 128, fitting a hom i$ 
unnecessary, as ViewSheet is already installed within the Megabit 
ROM. Licences ore also available from Acorn to allow one copy of 
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VlewShect to be used on all the micros attached to a network, using 
sideways ram. 

If the ViewSheet ROM is inserted in the highest priority socket, the 
computer enters the application immediately upon switching on, or 
whenever CTRL-BREAK is pressed. More usually the computer is in 
basic Or another language, and VieivSheet can he started by typing: 

* SHEET 

at the usual V or '=>' prompt. 

At this stage, a familiar VIEW family screen is displayed: It shows the 
application name, the amount of memory free and the screen mode in 
use. This is the Command screen: 

Lty+.fl p I r*s 
Edit tnq «? FJU* 

HwV T 

Printer [iaUult 

The flashing cursor lies beside the Command prompt J =>\ and various 
commands can be entered here. Many of these duplicate commands 
used in View. As an example, type: 

NODE l 

to change the screen mode. Aft the usual system commands can also be 
used, to catalogue di&cs (*Cat nr +.), to define the function keys (*key) 
and to switch to another language (for example, +BASIC). 

ViewSheet works in a similar way to VIEW; pressing ESCAPE at the 
Command prompt makes the spreadsheet appear. This is the Sheet 
screen. Pressing ESCAPE again at any time returns to the Command 
screen. Commands also work in a similar fashion to VIEW; command 
words like MCOt 3 work only in Command mode. On the Sheet screen 
single key commands .ire assigned to each of the function keys, such as 
CO TO SLOT (f7) or INSERT CHARACTER (tSJ. 

This separation of Command and Sheet modes is perhaps the least 
typical feature of ViewSheet Most other spreadsheets allow 
commands to be entered onto the Sheet display, usually by prefacing 
them with a '/'or 'V character, or by using a Command menu. 
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At the very tap of the screen Is ViewShset'S Sheet display, a four-line 
area set aside for status information Most of the Sheet screen is made 
up of a large number of boxes or cells f sometimes also called slats. The 
ceils are arranged in horizontal rows and vertical ca/tumis, Across the 
lop of the cells is a line of dots shoeing the names of several columns, 
and running down the lefl ts a dotted border and the names of some of 
the rows- Column names are designated by letters, and the rows are 
referred to by number. Any single cell can be referred to by its column 
and row names, column first. For example, the top left cell is named Al 
Below this is cell A2, and to the tight of A2 is cell B2. Cell C4 is 
highlighted in figure 2.1 

A £JLDT-*1 

CflWTWE-+BWDC* 


CELL Cl 


Figure 2.1. The Sheet screen, illustrating cell C4. 

The Active Cell 

One cell on the screen is picked out in white,, and with a V prompt. This 
is the cdl cursor, and it marks the active cWJ. The name of this active 
cell is shown at the top of the screen, far example, In mode 7, 

the active ceil is not picked out in white, and is instead indicated only by 
the V prompt. 

The active cell can be changed with the cursor keys. Press the DOWN key 
once to make A2 I he active cell, and RIGHT to make B2 active. SHIFT 
combined with die cursor keys makes the active cell move by a whole 
screen width instead of one row or column at a time- If you move the 
active coll as far as possible in each direction, you"]] discover lhat the 
whole sheet is 255 rows deep flabelled one to 255) and 255 columns wide 
(labelled A to Z, AA to AZ, BA to RZ and so on, to TU). 
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Another way to change the active cell is provided by the <;o to SLOT 
function, by pressing f7 followed by the name of the required cell For 
example typing; 

T7 kl 

makes AI the active cell. 

The whole sheet contains about 65,000 cells, plenty at room for even the 
largest jobs that the mat: micro can handle. Only a few of these cells arc 
visible at anyone time, the exact number depending upon which screen 
mode used. If mode 0 is used, nine columns and 26 rows are shown, but 
m other modes, fewer cells are shown on screen. No matter which 
mode is used, the Sheet screen can be scrolled to bring any of the 65,000 
cells into view. 

The Contents of Cells 

On a new sheet, each ceil starts off blank and this ts shown at the top Of 
the screen, for example: 'conteut3=-slamk - \ A cell can he filled with one 
of three types of item: a mint?, which is a piece of numerical data such 
as'127', a formula like 'A5 * 10 + A6', which describes how the data 
from other cells should he used to get the desired results, or a lahW, 
which is text such as 'Total to date'. 

Entering Labels 

The simplest cell type Is a label To put a label into a particular cell, 
perhaps B3, first make that cell acti ve, by using the cursor keys or GO TO 
SLOT. Once the cell 03 is picked out in white, the label can be entered by 
typing in a word. Characters typed don't appear directly in the active 
cell, but at the top nf [he screen next to a new flashing cursor that 
appears as the label is typed in. This is the Edit line and Edit line cursor. 
A label might be the name of a month such as JANUARY'. The label is 
transferred from the Edit line to the cell when RETURN is pressed. At the 
top-left of the screen, the V shows thai the cell now contains a label A 
label can be anything that is not cither a value or a formula. 
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Editing the Cell Contents 

If you type in the wrong thing the contents oi a cell can be corrected. 
When tke cell containing 'January' is active, it can be changed simply by 
typing in a ne w label: 

HA AC It 

This is the quickest way if the change is a major one. 

If the error is small, the cell can be modified. Pressing the COPY key 
copies the current cell contents to the Edit line, where the text can be 
jittered. To change a single character, simply type the new character 
whilst the flashing cursor is over it- The nashing cursor can be moved 
along the Edit tine by using CTRL-LEFT and CTRL-RIGHT. 

To make bigger changes, some of the function keys can be used just as 
they are in VIEW. Characters to the left of the cursor can be replaced 
with spaces by pressing DELETE. The character at the cursor is removed 
with 19. Pressing ta inserts a space into the line at the position of the Edit 
cursor. DELETE end OF L1NL (key 13) deletes the part of the line beyond the 
flashing cursor. Pressing f4 or 15 moves the Edit cursor to the start or 
end of the line respectively. After the correction has been made, RETURN 
inserts the new contents back into the active cell. Whilst using the Edit 
line, ESCAPE abandons the alterations and the original contents of the 
cell are retained. Practice all this by changing 'MAtCH' to APRIL'. 

If RETURN is pressed and VicwSheet deddes there must he an error in 
the line, the computer beeps. When editing that cell's contents, "Error ? 
is displayed in the ceLI and a message may be shown in the status area; 
the ceil contents can be copied to the Edit line with COPY and then 
corrected. At other times, the flashing cursor is automatically placed an 
the offending text, and an appropriate error message is displayed. The 
line can be re-edited and RETURN pressed again. 

Labels can be of any length up to 240 characters, because that is the 
maximum size of the Edit line. Of course neither the Edit line nor the 
cells can display all of a label that size. Cells 10 units wide, for example, 
always show the first 10 characters of the label. The Edit line can be 
scrolled left or right using CTRL-LEFT and CTRL-RIGHT, or the BEGINNING 
OF line and knd OF LINE function keys. 
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Entering Values 


To enter a value in a particular cell, perhaps next to 'march' in ceil C3, 
first make that cell active, Nothing can be typed into any cell until the 
cell cursor is moved to that cell, Now type a number, say 59, in the Edit 
line, and press RETURN. The number is transferred to the cell and the 
dag at the top left becomes V to show the ce]! contains a value. 


Value cells can only contain numbers: either integer numbers like 1 or6 
or 15, or real numbers like 0.75, -12,1 or 3 921569. Unlike BASIC, 
ViewSheet treats integers and real numbers In exactly the same way, 
Realty big or very small numbers can be expressed in exponent notation: 
1 23E6 means 1.23 multiplied by 10 to the power of six (1.23x10*), which 
is 1,230,000 


The numbers entered into cells are often called constants; although they 
can easily be changed by editing the slot contents, they can't vary while 
a sheet is recalculated. Now the following labels and constants can be 
entered into the cells below 'APRIL' and '59*'. 


hay ts 

JUWE 4 5 


The value 45 should go in cell C3 f and the sheet should now look like 
figure 2.2. 1/ there are any cells filled that should be empty, they can be 
emptied using SHIFT— Jg-. this is a Delete 5iJOT function, and it returns a 
cell to its original blank state. If a cell contains some tiling wrong, 
typing in new information or editing the cell contents works in exactly 
the same way for values as it dues for labels. 


WA EEUF-3 



Figure 2.2. Trial sheet with three labels and three values. 
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Formulae 

A formula is like an expression in BASIC It is an instruction to do a 
i numerical calculation. This expression or formula might contain 

constants in the same way as value cells, use arithmetic operations like 
tiddition or division, call mathematical functions like sin or log or use a 
, few special spreadsheet functions like BOW. 

In BASIC, an expression may also make use of variables - in ViewSheot, 
the equivalent is a cel 1 / reference, A reference is the name of a cell, and 
the numerical calculation makes use of the value tn the named cell just 
as a BASIC expression makes use of the value of a variable. 

To enter a formula into cell C7, make C7 the active Cell Now type: 

C3 4 C4 + cs 

in the Edit line. This is the formula, and k remains associated with the 
cell Contents- c3+C4+CS' is shown in the status area. However, what is 
shown on the sheet itself is the value of the formula, 150, because 59 + 
46 + 45 = 150. The cell contains the formula, but the sheet shows only 
the value of the formula To emphasise this, the Hag at top left shows 
V. 

It is good practice to mark any formulae to show what they do. The 
formula in C7 adds together the three values above it, so put the label 
TOTAL' in cell B7. 

Adding up a column of figures is such a fundamental operation for a 
spreadsheet that there is a shorthand way of expressing C3 + C4 + C5 
This can be used in the next formula, to work out the average of the 
three values. Put this into Cell Cfi: 

C3 C5 / 3 

Now the status area shows 'con tents -cues / y. In this formula, C3, C5 
is a nailer, and it indicates the sum of the values in the range of cells 
between C3 and C5. The average of the three numbers is this sum 
. divided by three, and the value of the mean £50) is shown in the cell 

The sheet should now look like figure 2-3- The sheet has all three types 
of cell on it: labels, values and the t wo ne w formulae. 
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Figure 2.3. The trial sheet after defining two formulae, 


But Why Use a Spreadsheet? 

A computer is useful if it helps in doing Something bettor, quicker or 
more cheaply, or does something new A spreadsheet fails the last, 
because everything I hat a spreadsheet application can do, can also he 
done by hand, with a pencil and paper, or with the help of a calculator 
So how can VicwSheet help? 

Try this: move the cell cursor toO and replace 59 with any other 
number say 68, When you press RETURN, 59 is overwritten by the new 
number but the total in cell C7 and the mean jn C8 both change too! 

This is why a spreadsheet is useful. Once 6he formulae are set up, they 
are recalculated automatically if any changes or alterations are made to 
the data values. 

Imagine the spreadsheet is being used to calculate the cost of a new 
garden walk The cost of the wall is made up of a number of smaller 
costs: the price of the bricks to build the founda tions and wall, cement 
and sand for mortar, capping stones for the top of the wall and labour. 
Certain costs depend on the length qf the wall, other costs depend on 
the height as well as the length. Instead of doing each calculation 
individually for every job, a builder might construct a spreadsheet that 
allows him to quote a price for any length and height of garden wall, 
including the right formulae for each element of (he total cost. Just type 
in the length and height needed and the price is calculated immediately. 

This rapid recalculation is also invaluable when a spreadsheet is used 
for forecasting, perhaps a business plan for some new venture The 
spreadsheet: can be used to answer 'what if questions. What wall 
happen if the interest rate goes up? What if sales are only 300 per 
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month? Alter the cells containing the rate or the sales figures and the 
forecasted financial position will be updated immediately. 
Experimenting with the data on the sheet can help to make the financial 
position understandable. 

Go Forth and Replicate 

Other reasons for using a spreadsheet can be demonstrated by adding 
the following labels and data to the sheet: 


cull B1 

SEAS 

cell Cl 

This RETURN SHEFT-fg 

cell DI 

Lut RETURN SHIFT-ffl 


53 

cellDi 

n 

cell D5 

3B 


Pressing SHIFM& (the justify LABEL function) hrlps to tidy up the sheet 
by altering the way the label is printed in the cell The label is aligned 
with the right edge of the slut rather than the left edge. A further press 
of SHIFMS changes it back again 

Doing all this makes the sheet look like a comparison of. two sets of 
data. It would be useful to compare the total and average figures too. 
Of course you could iype in the formulae again. Into cells D7 and D0, 
but there Is a better way. 

The REPLICATE function is a means of copying the contents of cells to 
other cells; the contents may be labels, values, or as in this case, 
formulae. To copy the formula for the total from C7 into D7. press to 
The prompt 'from - tg f appears in the status area, so type in I he 
source and destination tells, separating them with a hyphen; 

From - To? 

C7 - B7 

If the source cell contained only a label or value, it would be copied 
straight away, but C7 contains a formula C3 + C4 + Co This formula 
contains cell references, so there is a problem: should the new, copied 
formula refer to the same cells, or to different cells? 

If the formula were copied without change, then the value in cell U7 
would be the same aft in C7 This would be an absolute replication. 
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because the formula would always refer to cell?? C3, C4 and C5 no 
matter whm the formula was on the sheet However, this formula 
should not refer to specific cells, but to cells with the same position 
relative to the formula. Th ink of this as in the column above, rather 
than hi column C. This \& a relative replication, and so C3 should be 
altered to D3, C4 to EM, and so on Now answer the prompt for each 
cell reference in the formula; 

HIaiative, mo change? 

R 

As this is done, the formula is shown in the status area, with each cell 
reference highlighted in turn. In this case, R must be pressed three 
times, as there are three cell references in I he formula being replicated. 
Pressing N instead of R would result in an absolute replication. 

Replication is a powerful tool. It can deal with ranges of cells, large 
blocks of cells, and mixtures of absolute and relative references. These 
will be introduced later. 

An Important Point 

Begin to replicate the average formula in the same way, by pressing TO. 
When the J n r: r 7 .* 7 * prompt appears, move the white cell cursor to 

CB with the cursor keys, and press Shift-copy This copies the name of 
the cursor's cell onto the Edit hoe, where it forms part of the formula. 
Now type a hyphen, move the cell cursor to D8 and use SHtFT-COPY 
again, then return to end the line. While pointing to the ceils CS and 
D8 with the white cursor, think of this as replica ting from there to 
there. 

Once again, this is a relative replication, because the D3 formula should 
refer to the cells above DR, not the actual cells used in the O formula: 
C3 C5 / 3 should be changed to D3 D5 / 3. The whole replication 
sequence looks like this; 

TO 

From - 70 ? 

Cfl - G0 

R) el at £ ve, ?*j 0 chan ge ? 

R ft 

Note replication does not necessarily involve the white cell cursor. It is 
only used for pointing. 
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Pointing is equally useful wb«l entering formulae. When the flashing 
Edit line cursor has appeared, the cell cursor can be used for pointing. 
When RETURN is pressed, the cell cursor snaps back to the original active 
cell and the completed formula is put there. Pointing is generally less 
prone to error than naming each cell individually. 
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Figure 2-4. The trial sheet almost complete. 

Saving and Loading Whole Spreadsheets 

This first model is now almost complete. A complete sheet such as this is 
often called a model because financial pknnjnc and modelling have 
been the major use For spreadsheets. To conclude this brief look at the 
facilities of Vie wSheet and the building of a simple model, five 
important commands are described and explained. All work only from 
the Command screen. 

The completed model can be saved. If necessary, press ESCAPE to 
switch from the Sheet screen to Command mode. At the '=>' prompt, 
type the following: 

SAVE <BGd* 1 -name > 

where <model-name> is a filename suitable for the current piece of 
work. Use a filename like 'GROWTH* The whole spreadsheet is saved to 
the file on the current filing system. 

Tape: The filename can be up to ID characters long. After the 

save command, 'recohi:] then returi/ is displayed on the 
screen. Hut in a blank cassette and press the RECORD 
button, then press RETURN. Eventually, the Command 
prompt reappears, and the model has been saved 
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Remember to label the cassette. Try to use? the same name 
you saved it under to avoid confusion. 

Disc: The model-name may have up to seven characters, plus 

drive name and directory name il necessary, for example 
*\\ ,m,growth". Make sure there is a suitably formatted 
disc in the drive. Keeping all View&hecd files in a single 
directory is a good idea, perhaps M for models, as it helps 
to keep them separate from other types of hie. Try not to 
use S for sheet, because ViewSiore uses S for selection 
files- 

ADFS/Ncl: Directory and file-names may be up la 10 characters long- 
h's best to keep all the Views heet hies together in a 
directory called VSHEET, and use this as the current 
directory as follows; 

AfllH VSHBET 

The filename could then be 'GROWTH' Eqtutlly, it could be 
a full path-name .vsi IEet.growth 1 Note that the 
directory VSEiEET must be created with *CD m before it can 
be used: 

•CEJJR VSHEIT 

When working with ViewSheet, save regularly. The saved copy is useful 
when the spreadsheet data is lost by accidentally replicating from a 
blank cell to a huge range of cells, or when the cat switches off the 
computer! The model can be given a name by typing: 

EfAKE Cmadal-nuw} 

The name is shown at the top of the Command screen, as 'Edit i nq 
; i■ v ■ growth-' for example. Once the model has a name then the SAVE 
command can be abbreviated to just: 

SAVE 

When a model has been saved, the sheet in memory can be cleared with 
the NEW command ViewSheet makes all the cells blank and gets ready 
to build another completely new model. 
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Typer 


Be careful, because unlike basic there is no old command that retrieves 
a sheet after it has been cleared. AU trace of the old model is lost, so 
always save fired AfteihfHW, ihe Command screen shows 'Edit ing no 
file , 


The LOAD command can be used to reload an old spreadsheet back into 
memory from a file: 

l oufi <o ld-andt 1 -n sum > 

cold-model-name> is the filename that was used to save the model. 
Take t are, because loading an old sheet obliterates any model currently 
in memory. When reloaded, the model will be in exactly the state it was 
in when the save command was used, and the model-name will be 
shown on the Command screen. 

Tape: insure the cassette is rewound, and press the fla'* button. 

'lcm " l,r loads the first file on the tape. 

Disc: The filename may include the drive and directory names 

too, for example Mm.GROWTH'. 

A DFS/Nl t: The filename could also include a directory name, or be a 
complete path-name, eg VSMEET.GRGWTH' or 
*S vs HEE1 GROWTH' Consult the network manager if 
unsure of the best place to save a file on the network- 

Atter loading, the Command screen is updated to show the new 
filename and the amount of memory left. It might show: 



9jr£«i Tew fill? 

Ti-| 1 1 1 rvj :i , h.CiP^VTH 

Scrwr. m4w 1 
PxJuvtiu da fnil1 


and everything is ready for using the model again. 
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The last command needed to get going on ViewSheet print. To prim 
out the sheet, first set up the printer, Lf you have a parallel interface 
printer feme that attaches with a ivide ribbozHikc cable), then you just 
plug it in. 

Serial printers (plugged into the port marked ES423 on the back of the 
13 HC micro), network printers (attached to a printer server elsewhere 
on the Econet) and Master Series need sped a 1 attention as follows: 

Serial: Select the serial printer by typing: 

*Tt s # a 
■W 7,7 
*FX «.7 

Serial printers work at different speeds, These commands 
give a speed of 96GD baud; if the printer needs anything 
different, then check the commands #FX7 and *fxs in your 
micro's User Guide. 

Network; Select the network printer by typing: 

*FX 5,4 

The #ps command may also he necessary to select the 
printer server, if it is not for example, station 23S. if the 
network printer is not attached to station number 235, then 
consult the network manager. 

Master Series: The Control Panel or I he ^CONFIGURE command can be 

used to set up the printer^ so that the above commands are 
unnecessary. For example: 

*roMFtctme mod 7 

does the same as *fx 77 and *fx s,7, ^configure itunt i is 
the equivalent of *fx 5 ,4. 

When the printer is set up, the sheet can be printed out by typing: 

PRINT 
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It should be printed exactly as it looks on ViewSheet s Sheet screen. The 
model muit he saved and in the micro's memory to print it out. Files 
can't be printed without loading them first- 

One common problem that occurs is the print out is all on one line. If 
this happens then enter; 
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Model 


A Little Pre-planning 



Tii cet VtewSheet to help with a particular calculation, it is necessary \n 
build a model that mimics the method used to make the calculation by 
hand, with paper, pencil and calculator. It is often not worth building 
the model If the calculation is to be performed only once. However, if 
the job has to be done regularly, a spreadsheet saves time. Building the 
model is similar to programming, hut simpler because most of the 
difficult work his already been done. All you do is specify the data, the 
inter-relationships between the various pieces of data, and the 
formulae that link them together in various cells. 

As with pri^ammirig, planning pays- Before starting to type in a new 
model, it is useful to write down the types of data and all the formulae 
involved. Then sketch a preliminary fay out for the sheet, showing 
where and In which cells you want to put the data, and take Into 
account the rules below The plan should resemble the way the same 
problem might be solved by hand on a big piece of paper. A typical 
sketch is shown in figure 3 1. 
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Figure 3.1. A sketch indicating a rough model layout. 

After designing the rough outline, a start can be made on typing in the 
data, labels and formulae into the predetermined areas of tne sheet. 
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Leave Room for Labels 

There lire two rules to follow' when defining the layout for the data and 
formulae on the sheet. The first important rule is, never put the first 
piece of data in cell Al; always leave a few rows and columns around 
the edges of the sheet so that any labels can be inserted, in the trial 
model 'growth', the first value went into cell C3, $o two rows and two 
columns were left free. This also applies within the body of the model: 
leave plenty of room for lahels near cells containing formulae. 

Direction of Recalculation 

The second layout rule is that when entering your figures, you should 
generally proceed downwards and right, across the sheet. En 
particular, a formula should only make references to cells that are 
either in a lower-numbered row (that is, higher up the sheet) or the 
same row buE an earlier column, As an example, a formula in cell C7 
may refer back to any of the ceils in rows one to six, plus A7 and B7, hut 
should not refer forward to D7, E7, or any succeeding cells. Figure 3.2 
illustrates tills. 


yet 

yes 

yes 

yta 

yes 

yea 

yea 

FORMULA 

no 

no 

no 

no 

flO 

no 
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Figure 3.2. Cell values a formula may refer to. 

This is necessary because of the way YiewS&eet recalculates the values 
of all the cells whenever a change is made to the sheet. The first to be 
calculated is the altered cell then Al r then Bl, continuing through all of 
row one to IU1 before calculating the value of A2, B2 and so on. The 
direction of recalculation is from left to right along each row in turn, 
from row one to row 255. 

Skip to the bottom of the next page if the next bit looks too technical 
This direction of recalculation might not seem important. After all 
every time a cell is changed, that particular cell is evaluated 
immediately. Then the sheet is recalculated, so an up-to-date value for 
the changed cell is used throughout. However, when a cell is altered, 
formulae rearing to that cell are not recalculated immediately, but 
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must await their normal turn. Therefore, cells making a forward 
reference to these other formulae will be evaluated Incorrectly. 

To demonstrate the importance of this, load the trial model 'GROWTH', 
and enter these new cells: 

cell El chahge, RETURN SHiFT-ffi 
cell E4 [c9 / &B - it * 100 

This makes E4 show the correct percentage growth of the average 
figure between last year and this, 20.4545. Now alter cell D3: 

cell D3 so 

The total and average figures for last year are updated correctly, to 159 
and 53, so last year and this now show no overall change. But tell E4 
still shows 20 per cent growthf When this cell was evaluated, the old 
average was still in cel IDS. 

To he evaluated correctly, the percentage change formula should be 
placed below the average figures to which it refers. Delete El and E4 
with SHIFT—f9, place a new formula in cell CIO and label in 010: 

cell BID CHANGE 

cell CIO tea / m - i\ * ice 

Mow, even when the data is altered, the change figure will always be 
correct; alter D3 to 74 to check, and the sheet should look like figure 3.3, 
indicating about four per cent growth from year to year. 
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Figure 3-3, A correct place for the CHANGE formula. 
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In fact, formulae often do refer to cells they should not. The best advice 
is that it is fine to refer forwards to ordinary values, but never forwards 
to a cell that contains another formula. 

Another problem occurs when a cell formula refers to itself. This can 
happen very easily when a column total is calculated, imagine cell C? 
containing I he formula C2 C7, instead of C2 Ch- It's harder to spot 
when the self-reference is indirect when one ceil refers to another and 
the second refers to the first. This is a circular reference, hut it can't 
happen unless one of the cells first breaks the rules and makes a forward 
reference. 

Displaying Numbers on Screen 

The wav in which numbers an? d isplayed in ViewShwt is called the 
number format. For example, the number 37.5 can be displayed as 37-5, 
or 37-5000, 3.75E1, or even 38. Each Is a different format. 


Formats for Individual Cells 

The value of the formula m cell CIO of figure 33 is shown as 3,92157, 
The precision with which the value is displayed can be altered using the 
EDfl SLOT FORMAT function. Make CIO the active cell and press ffi; the 
current rail fonnnt appears on the Edit line where it can be altered: 

16 

Format? 

FRH 

The format FRM has three elements. The first indicates whether the 
value displayed should have a floating decimal point, or a fixed number 
of decimal places: F, D1, D2 and so on The second, L or R, shows if the 
value should be placed to the left or right of the cell- The third controls 
whether negative numbers should be shown with a minus sign, M, or in 
brackets, ft: that is -1234 or (1234). Brackets are used widely in 
financial work. 
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Try a few of the following examples out in cell CIO: 


fiiRH CIO shows 

D2FUI 


3.5 

3*92 


P3U4 
FFS 
PDM* 
P6 Ml 


3. 921 
3.9215 


4 

1 


In the last of these examples, a cell showing *%' indicates that the value 
associated with the cell can't be displayed in the chosen format. The cell 
is only seven characters wide. The format asks for six decimal places, 
which requires eight characters (3,921569), so the slot is too narrow. If a 
value doesn't fit the format, then it is shown in exponential form. If 
that doesn't fit either, then the per cent sign is shown 

Change the formal back to DORM. The DO indicates rounding to the 
nearest whole number - 1,5 is rounded upwards to 2,1.49 is rounded 
down to i - c ind so the value of the CIO formula is rounded to 4. Briefly 
return to the Command screen and save the whole model in this sfote 

However precisely a value is displayed, ViewSbeet stores it internally 
to full nine figure accuracy. This can be demonstrated by putting the 
formula do * joo temporarily in some other cell. The value of this is not 
400. but 392.157. Cell C10 shows Ihe rounded value, but the true value 
is used in other calculations. 

Changing the Format of all the Cells 

Cell formats may be changed individually, but alterations can also be 
made to the whole screen., by using the EDIT WINDOW function. Tress f 1, 
View Sheet then asks for the window number, This is the number that 
appears In the upper left comer of the sheet area of the screen, below 
the status area, and at present this should be 0. Finally, the current 
window definition appears on the Edit line: 


ti 

Window? 

0 


Wt Tapt ftOtR FES CW Bw FJflt Opt 
0 AI 1 19 1 1 FRM 
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This definition line can he edited in Hie normal wray by using CTRL-RFGHT 
and CTRL-LEFT to move the flashing cursor along the line, and 
overtyping items as required. Wi is the window number, and should not 
be changed fur now, TneTopL and BotR cell references show the part 
of the sheet that is displayed In the window, and again they shouldn't be 
Altered. 

Cw is the width of the columns. By default, each cell can display seven 
characters, but this can be altered. If Cw is edited to 10, then wider cells 
will be displayed, but there would be space for fewer columns across the 
screen. ViewSheet automatically decreases BotR to take this into 
account. Cw can vary between three and the total width of the screen: 
narrow columns squeeze more cells into the display, wider ones allow 
longer labels or more precise number formats. If the per cent sign is 
shown, then increasing the column width may allow the full value of the 
number to be displayed. 

Bvv is the width of the dotted border down the left side of the screen. 
This can vary between two and IS. 

Fmt is the window format, and it follows the same rules as the format 
for individual cells. Load the 'GROWTH' model, and try changing the 
window format to D1KM: 

Wi T<jpL BOtR EOS Cw @w Fmt Opt 

0 u Hi 1 1 tuft* 

After pressing RETURN, the cells change so that all the figures have a 
single decimal place. The exception to this should be the CIO cell 
containing the CHANCE formula. This should still have an individual 
slot format DORM set - these slot formats take precedence o ver the 
window formats. To delete the slot format for CID, begin to edit it 
(with f-S) and delete the whole thing (by pressing F3 arid then RETURN), 
This makes CIO follow 1 the format rules set for the window as a whole. 

Doing Arithmetic 

Simple arithmetic can be done on the sheet Ordinary numbers, or 
constants, are linked together with operates 
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The standard operators, in order of decreasing precedence, are: 

A raise to the power of 

* multiply 

/ divide 

+ add 

subtract 

Precedence means that the multiplication in a formula is normally done 
before any addition - it has higher priority. If you need to- put operators 
in a different order, brackets may be used. For example, 10 * 3 + 5 is 35, 
but to* <3 + is 80. 

Formulae can also contain conditions which may bo 'true' or 'false': 

10 > 3 is true, whereas ID = 3 is false. True has the numerical value of 
one, and false has the value zero. The usable conditional operators are 
as follows: 



equal to 

< > 

not equal to 

> 

greater than 

< 

greater or equal 
Jess than 

< = 

less or equal to 


These always have a lower priority than the mathematical operators, 
so IG * 3 > 10 + 3 is evaluated as ((10 * 3) > (10 + 3)). The value of this 
formula is 1; 30 is greater than 13, so the formula is true. 

Built-in Functions 

All the usual arithmetic, trigonometric ±md logarithmic functions are 
available using ViewSheet Many will be familiar from calculators and 
from BASIC, and, with very few exceptions, they work exactly as they do 
in BASIC. An example of a formula using one of the built-in functions isr 

£$R fD5 - DA I 

This formula gives the square root of the difference between the values 
in cells D 5 and D4 Note that DS must be greater than D4. otherwise an 
error occurs as ViewSheet can't find the square root of a negative 
number. 
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Note, all the ViewSheet functions need brackets around the Argument 
(the argument is D5 - D4 in the example). If they are omitted, the 
formula is treated as a label. Spaces between the function and the 
opening bracket are optional. 

Special Spreadsheet Functions 

All spreadsheets have an extra group of functions especially helpful in 
constnn ting models The way they work varies between Spreadsheets, 
and this often forms the major difference between rival packages. 

ROW and COL 

The simplest among ViewSheet's special functions are ROW and COL, 
The value of each of these depends upon which cell they are in. A ROW 
function in cell E7 has the value seven because B7 is In the seventh row- 
in cell DIO, it has the value 10, 

In cell £17, COL does not have the value tl. but two, because B is the name 
of the second column, Clearly, in cell DIO, COL gives the value four. In 
cell A A10, the value of COL is 27, because AA comes after column Z 
(which is column 26). The last column IU has a col value of 2b5- 

Figure3.4 illustrates a 12 by 12 multiplication table constructed by 
putting the formula 'row * coT into 144 cells on the spreadsheet, As 
shown, the value of this formula in cell K3 is II * 3 (K is the 11 th 
column), or 33, 
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Figure 3.4 12x12 table constructed with ROW and COL 
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Summing up a Range 

Another straightforward group of functions are related to ranges (parts 
of a single row or of a single column). The simplest of these is the SUM 
function, which doesn't really exist f However, there is a shorthand 
form of SUM.To add up the values in the range between D5 and DIO, the 
formula is jttsh 

D5 DIO 

which means: 

D5 + DC * t>T + Ufl + D* + DID 

Many other spreadsheets have an explict SUM function, but this is 
unnecessary in View Sheet- 

One point to consider is whether the range specified for summing 
includes any blank cells or any labels. The values of these cells are taken 
to be zero: they don't count towards the Sum. 

Related to the sum function is AVERAGE (nl, n2 r — This function takes 
as its argument (the bit in brackets) a frsf. The list can contain any 
combination of constants, cell references, other functions or ranges. 
Items in the list are separated by commas. For example: 

JLVEHJLSE (12§> C2 C5 r D2 D5, LOS {t2\ ( 

would add together 125, t he values of the four cells in each of the iwo 
ranges C2 to C5 and D2 to D5, and the logarithm of the value in cell £X 
and finally divide by 10, the total number of items in the list 

The range C2 C5 contains four items, but what happens if one of the 
four cells in the range is blank? As with SL r M, a blank cell makes no 
contribution to the adding up, but it does still get counted as an item. So 
the AVERAGE of the range is not the average of the cells with values in 
them. AVERAGE underestimates if there are any blank cells or labels in 
the range, so you must make sure that these are not accidentally 
induded in ranges. 

The MAX (nl, n2, . ) and MIX (nl, n2,functions work in just the same 
way as average. They work out the single largest or smallest value in 
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their list Once again, empty cells or Libels must be avoided, especially 
with MIN, as they have a notinna] value of zero. 

There are five more special functions, choose, if, lookup, read and 
WRITE, which will be described in later chapters. 

Naming Rows and Columns 

Some times, using cell references in formulae can look a bit cryptic - just 
what does R2 Flifi mean? There Is a way of making this a little easier to 
interpret, by using the COLUMN HEADING and ROW I LEADING function 

key- 11 

From the Command screen, reload the 'growth' model and switch to 
Sheet mode. Make cell C3 active by moving the cell cursor, and press 
SKtFT-fS. A 'coluna heading i‘‘ prompt will be displayed, so type in a 
heading for the whole of column C The column contains the Figures for 
this year, so an appropriate heading is 'This', type: 

SHlFT-f3 
Column beading? 

This 

Now t do this for the whole of row three loo: 

SHtFT“f4 

Plow heading? 

April 

The status area of the screen now shows the following: 

VA SLOT- H Th 13**APR I L“ 

CQWTENTS=S8 

The slot is no longer called C3, but is known by its column and row 
headings: "This"April". 

Other headings can be put on the sheet in a similar way, and eventually 
the sheet should look like figure 3J. Spaces can be included in the 
headings, for example, row 10 is headed year to year 

The screen shown also has the border width CBw in the window 
definition ) changed to IS, so that there is room for the longest row 
headings. 
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Figure 35. Final trial sheet 


Once the row's and colimms are headed like this, then a cell can be 
referred to in a formula by any combination of its row number, column 
letter and headings, or by pointing. For example "This” April", C" April" 
or ^This"3 all refer to cell C3, but the first gives most clue to what the 
figure really represents. Formulae are improved loo: 

CONTESTS**Thi s*Apr iI * 1 ■ Th ia 1 - June */3 
Is a much more comprehensible description of the contents of O than: 
CONTENTS'* 3C5/3 

When using headings in formula or with the GO TO SLOT function key, 
double quotes (SHtFT-2) should be used In separate the row and column 
headings from each other and from other symbols, In this example, 
"This"ApriTThis"JuneV3' is the minimum VicwSheet could recognise 

Headings can be temporarily switched off. Press ESCAPE to go to 
Command mode, then type the command : 

headings off 

Back in Sheet mode, the row and column headings are not shown. They 
can be restored with the command: 

HEADINGS QU 

Taking Protective Measures 

When set up, the formulae in a model should not be changed 
i nadvertently. Imagine the havoc if the buildeTs quotation spreadsheet 
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mentioned parlier was altered to contain the wrong formula for the 
number of bricks! 

Individual cells can't be protected from alteration, but whole rows or 
whole columns can be locked to prevent any of their cells being altered 
accidentally. To lock a row, move the cell cursor to any cell on that row 
and press SHIFT-16- This is the PROTECT ROW function, and it stops any 
cell in that row being altered 

On our sample 'GROWTH' spreadsheet, it is wise to protect rows seven, 
eight and ID in this way- When these rows are locked, I he dots in the 
border containing the row headings change to underlines, indicating the 
specially protected rows. Any attempt to alter the cell contents in a 
locked row results In the message 'Protected' appearing in the status 
area. Pressing SHIFT-15 does the same for all the cells in a single column, 
When a cell is protected, it cannot be changed by typing in new contents, 
by editing its contents or by replication. An attempt to replicate to a 
protected cell fails, though the rest of the replication may succeed. In 
this case, no error message is shown, which can cause confusion. 

If it's vital to change a protected cel], it can be done, A second press of 
SHIFT—f5 or SHIFT-1S unlocks an individual column or row, and changes 
the border back to dots. You ran also temporarily unlock all the cells on 
the sheet. To do this# press ESCAPE to switch to Command mode, and 
type in the following: 

PROTECT OST 

Mow- on returning to Sheet mode, any cell can be modified. Entering 
PROTECT ON in the same way restores the previous protection. If 
PROTECT on its own is entered, then VtewSheet shows whether 
protection is currently on or off. 

Replication Round-up 

In the worked examples so far, replication has been used to copy from n 
single cell to a single cell and from a cell to a range of cells, using both 
absolute and relative replication. 

In fact, replication also works from a range to a single cell and from one 
range to another range Figure 3.6 summarises the seven available 
options; note that each replication involving a column range lias a 
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similar row-wise variation. The options missing from the set in figure 
3,b are the impossible replications from A row range to another row 
range, and from a column range to another column range. When 
replicating from one slot to another, any cell references in the slot 
copied must he specified as absolute or relative; the prompt is: 

RJeiatiw, *$) □ change? 

This may have to be repeated for each cell reference in the source slot. 
To replicate the formula U2*T2-C1, either R or H must be pressed three 
limes because there are three cells. 

When copying from a range, then this sequence is followed for each of 
the slots in the range. That is, the replication from m OS - E3 is treated 
as three separate celMo-ceJJ replications, D3 to E3, D4 to E4 and so on. 
The'ro el ative, tijo change d question must be answered separately 
for each of the three. Curiously, the questions are presented In reverse 
order; the formula in D5 is copied first, and that in D3 last. If this seems 
confusing, remember that the status area always shows which slot is 
currently being copied, and the Full contents of that slot, in the top two 
lines. This can be tried with the growth' model; delete 1 he two cells 
D7 and P8 by pressing SHIFT—H?- Now replicate the range C7 C8 to D7: 

(0 

From - To? 

CT C8 - □7 

At this point, the status area shows; 

1A SLOT*Ci 
CDtlTWTiJ-C^CSy 3 
ajudjui™, Hlu ehm^? 

C3C5/J 

This shows that the bottom of the C7 C8 range teeU Q$} is copied first. 
Completing this replication involves pressing R five limes, once for each 
cell reference In each of the formulae. 
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slot to slot 


eg. B17 E17 


m 





m 


a 




•Hoi to range eg, 017 - E17E19 
—-or — 
B17-E17G17 


am 

fT 


(three celts copied) 


range to slot eg B17B19 - El7 
— or — 
1317P17 - E17 


za 


(three odls copied) 



range to range eg. 0] 7B19 - E17G17 
— or — 

B17D17- E17E19 


(nine cells copied) 


formula 
refers here 


relative replication 





formula 
refer* here 



absolute (no change) replication 


Figure 3,6 Summary of replication options 































4 : Putting ViewSheet to Work 



A spreadsheet has to work for its living. Three real working models of 
increasing complexity are described next, along with new techniques 
and commands needed to make them function. 

A Household Budgeting Mode] 

The first working example is a spreadsheet for household income and 
expenditure. 

The major difficulty with household accounts is that while income is 
usually Weekly or monthly in the form of wages or salary, many 
outgoings are yearly and quarterly; for example fuel bills are quarterly 
and house insurance generally an annual outgoing. The mismatch 
between timescales often means it can be difficult to reconcile the two. 
Inevitably all the big bills arrive in the same week! So how much money 
has to be saved in the months with no bills? 

One way of planning this is to work out all the income and costs on a 
yearly basis, comparing like with like. All the regular costs for one year 
are taken into account, and Compared with the total income for the 
whole year. 

Initial Planning of The Model 

The first step i$ to sketch out the overall plan of the model, and this is 
shown in figure 4.1. Income is taken first, and w hether pay day is every 
week or only once a month, the total is converted to an annual rate. 

This is done by multiplying a weekly wage by 52, monthly by 12 or 
quarterly by four. Note that the income figures that should be used arc 
net, or take-home pay after deduction of tax and national insurance. 

The expenditure columns are taken in the same way. Finally the two 
total figures are compared. 
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Fsgune4J. InitiaI sketch for household budget model 

Think about number formate, The normal format is fhm (which means 
floating decimal point, right-hand side of the cell, minus signs if 
negative), but this doesn't suit this model. When displaying money 
va lues two decimal places are often required, so I he dike or pzRM 
functions would be better. 

The next thing is to note down all the household's sources of income, 
and all its regular cosls. Here is a quick list to start off with: 


income wages 

salary 

interest 

share dividends 

COSTS rent 

rates 

mortgage 

home insurance 

water 

gas 

telephone 

electricity 

petrol 

car tax 

loans 

car insurance 

food 

fares 

laundry 

life insurance 


Of course, not all of these will apply, and you may have different 
outgoings - if you have three cats, vet's bills and feeding them have to 
he taken into account! 
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Building the Model 

The basic aim of the model is to sum the total income and the total 
expenditure. Therefore the first labels to put in denote columns for 
weekly, monthly, quarterly or annual income. These should be put in 
ceils A3 to F3, as shown in figure 4 2- Note that some of the labels are at 
the left end of their cells, some at the right; Justify i.aef], (key te) can be 
used to swap them across. 

ui ELcrr^ra 


ft ...... .Ik.. . .. ..B.._C. .. D...£._ r 

■r 1 - - -, i BCOEE bhuxst 

_ 2 _ 

-.- - 3 IHraC Hhi Nheitii Ctu.rL« Vnai EM^WITO 

Figure 4.2, Beginning a household budget model. 

Now a row should be set aside for each source of income. The first in 
this example is Janet's salary, and this is labelled in cell A5, Janet is paid 
£520 net monthly, so her Income is put in cell C5, the monthly column. 
John takes home £131 per week, so this is put in cell B6, the weekly 
column 

Column F is to hold the annual equivalent of each income source; if the 
income is weekly then multiply it by 52 to give the annual income, if it is 
quarterly then multiply it by four, the formula In cell F5 can be entered 
as follows’ 

52 * M + K * Ci M 1 us * Si 

Remember to point at BS and the other cells whilst doing this; use the 
5HIFT-COF |, Y facility instead of typing r B&\ As B5, D5 and E5 are blank 
their value Ls zeroise the total is merely 12 * C5, or £6240. This is the 
annual equivalent of £520 per month. 

This formula can be replicated from one cell to another, that is from F5 
to F6, Press (0 and reply: 

rs - rs 

to the prompt. Then press R as needed. This is relative replication; each 
formula should refer to the cells to its left, nut just the same cells as the 
original formula. Tire income section is completed with Some more 
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labels and,, in cell FB, the formula F3 Fb to give the sum of the cells 
between F5 and F6. Figure 43 shows the model at this stage. 
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Figure 1 4.3, The income half of the budget model 

The expenditure half of the model can be constructed in a similar 
fashion. First, type in any labels necessary using the model sketch as a 
guide. There should be an EXPENSES label in A lt), and below this a list of 
expenditure headings. For now, type in only five spending categories: 
mortgage tor rent), rates, gas, telephone anti electricity. 

Now the formulae for the annual equivalents can be put into column F 
The?ie formulae are just the same as those in the income section. Again, 
relative replication should be used , but this time from a single cell to a 
group or range of cells. Press KEPLICATT- (key fO), and type: 

F5 - WU fl6 

Then press B to indicate relative replication. 

The final formula in this section should be in row and it denotes the 
sum of the five expenses rows: 

ri2 Fie 

This formula is, of course, the equivalent of F12 + FI3 + FI4 + FI5 + 
Fib. 

Now the actual costs of the five items can be typed into the relevant 
cells. A mortgage is paid monthly, so the cost goes in cell Cl2; gas bills 
are quarterly, so the average size of bill should go in D14. 

At this stage it is convenient to alter the number display format. This is 
done by editing (lie %vindow definition. As this model shows amounts of 
money, it is an advantage to show all figures with exactly two decimal 
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places. The format needed is D2R.M, To alter Lhe window definition 
press tl (EDIT window), and answer the winded' prompt by pressing 0; 
then edit the definition: 

Wi fppL BotR Fos Cw Bw Fmt Opt 

0 M 156 10 f d;rm 

At the same time as altering the number format, the Column width can 
be Increased so that labels with up to 10 letters can be shown in full. 
Remember this will leave room lor fewer columns across lhe screen. 
After this section is completed, the sheet should look like figure 4-4- 
Rememfcer to save the model perhaps using the filename 'HOUSE": 
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Figure 4.4. The completed household budget mode!. 

Inserting Columns and Rows 

In figure 4,4, only five major expenses rows are shown, but other 
categories from the preliminary list can be inserted easily into the 
model First, make FIS the active cell, and note (hal (he status area says 
'cowsTS^ 12 F 1 £'. This cel! totals up all the individual expenses 


40 

























Putting VfewSheel to Work 


Move the white cell cursor to F14, and press INSERT ROW [function key 
SHIFT-f2), A new blank row 14 is inserted above the old one, and the old 
rows 14 \o 21 are shuffled down. Gas costs or any of your other 
outgoings can be put in row 15, and the new row 14 could be used to 
record the annual water rates bill, for example. Add as many rows as 
needed to get an accurate picture. 

The important point to notice is that the formula in FI 9 (the old H5) 
now says 'cos*: rn- k: 2Fi7\ ViewSheet tries to amend the formula to 
take into account the extra row, so the sum now includes the new value. 
The new water rates row was inserted into the middle of the range FI 2 
F!7. Now check what happens if a row is inserted at the beginning or 
the end of the range, Any new rows above row 12 (Mortgage) or below 
row 17 {Electricity} are ignored because they are outside the range in the 
original formula. 

New blank columns can be inserted in exactly the same way as rows, 
using INSERT cm UMN (key SHIFT-Ft 5. The new row or column always 
appears at the cell cursor position. 

Deleting Rows and Columns 

Blank rows and columns are usually a good thing. They serve to divide 
up the sheet into logical blocks; row nine in figure 4.4 separates the 
income area from the expenditure. However, there may be too many 
blank areas, Rows and columns can be removed, along with the cells 
they contain, by pressing CTRL-12 or CTRL-T1 while the cell cursor is in 
the correct column or row. These keys are marked DELETE COLUMN and 
DELETE ROW, 

before deleting anything, check the area is really blank. Run the cell 
cursor along the row; remember not all of the row is shown on screen at 
once, and there may be valuable data in the invisible section. So always 
be sure and check off-screen too. 

While deleting a row or column* the model must be temporarily 
unlocked by using PROTECT OFF in Command mode mentioned earlier, 
When protection is removed, switch to Sheet mode, position the cell 
cursor and press delete Column or DELETE ROW. The area is deleted and 
adjacent cells are shuffled up to fill the gap. Remember to relock the 
sheet with the protect QN command 
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As with insert row and insert column, ViewSheet attempts to adjust 
the cell references In all formulae to compensate for the changes, but 
fails if the deleted row or column is referred to directly. For example, if 
a formula contained a reference to cell C5, then deleting row five would 
cause problems: the reference would remain O, but C5 would then 
refer to the old CGI This should not cause problems providing that 
formulae never refer to blank cells, and nothing except blank cells are 
ever deleted. 

Extending the Model 

On the budget model, insert any other types of regular outgoings 
necessary The last two formulae, shown in cells F20 and F22 in 
figure 4.4, are the Net Income (Total Income - Total Expenses) and the 
Net Weekly Income (Net Income / 52). This final figure shows how much 
spare' money there is in Janet and John's pockets each week - money 
not already earmarked for something After inserting any new items, 
save the model again. 

The model can be used to check that any new commitment that Janet 
and John make, perhaps to a new savings plan or a bigger car, will not 
take away too much of their income. The figures can be varied at will 
and the overall effect of the change can be seen at once 

Statistics with ViewSheet 

Descriptive statistics are numbers that summarise a large group of 
meosurements. Best known is the average (or arithmetic wesrd, the 
sum or total of the measurements divided by the number of 
measurements. ViewSheet has a special average function to find the 
mean of a group of figures. 

Another useful description of a set of numerical data is the standard 
deviation. This illustrates the amount of variation or dispersion, ie, 
how much they differ from their average. This is also sometimes quoted 
as the coefficient of varmlitiu+ which is the standard deviation as a 
percentage erf the mean Wildly varying things like the heights of a class 
of schoolchildren have a high coefficient of variation, whereas steady 
figures like the weights of 30 wooden building blocks of the same size 
have a low coefficient 
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The Pebble Project 

This section describes the use of ViewSheet to work out the average and 
standard deviation of a set of figures. The example chosen is an 
investigation of the variation of pebble size on a beach; first the range of 
sizes at one place and second the range of average sizes up and down 
the beach. At spring low tide, the Largest area ot beach is exposed, from 
the finest sand through coarse sand, hue gravel and pebbles. At each 
pari of the beach, a sample can be taken: a little bag of coarse sand, a big 
bag of pebbles, a bucketful of shingle and soon. The individual sizes of 
311 to 4(1 pieces from each sample can be measured Even sand grain 
lengths could he estimated, using a hand lens to look at grains spread 
out on millimetre graph paper. Gravel, shingle and pebbles should 
present no problems. 

Now for the spreadsheet To work out a standard deviation for one 
sample, a worksheet is often laid out like figure 4,5. First come the 
measurements themselves, then a column showing the difference 
between each figure and the overall average Next a column showing 
the differences squared. The mean of these squared differences is found; 
this is known as the variance. The standard deviation is the square root 
of the variance- In fact there Ls a quicker way requiring only two 
columns, but it's much harder to understand! 



Deviation 

(Deviation 

Measurements 

from mean 

from mean) 

1 

-A 

16 

2 

-3 

9 

3 

-2 

4 

4 

-1 

l 

5 

0 

0 

6 

1 

l 

7 

2 

4 

a 

3 

9 

9 

4 

16 

Tolai = 45 


Total = ffl 


Number of measurement* = 9 *□ variance * 6D*9 - 6.7 

Sc trtgdH * 45*9 m 5 Standard Deviation = . J 6,7= 2,6 

Figure 4.5. Rough layout for a statistical model 
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This structure can he duplicated exactly on the spreadsheet. Into 
column B goes the list of measurements. The next column should be set 
aside for the differences, then the third column for the squares. 

Using Auto-Entry to Build the Pebble Model 

Figure 4_6 shows a few shingle length measurements, together with the 
first two formulae. Although the example sheet shows only nine, there 
should he at least 30 measurements for the standard deviation to be 
useful. When tvping in the measurements, AUTO ENTRY mighl help. This 
makes the cell cursor move each time RETURN is pressed, so it's ready for 
the next number Pressing CTRL-fO makes an V flag appear in the top 
left comer of the screen; the cursor moves right after RETURN is pressed. 
A second press of CTRL-fft makes aflag appear, and the cursor moves 
down. A third press switches AUTO entry off again if necessary. Ln this 
cose, where there is a column of figures to type in„ D is most useful 

vad sicrrnBi 

DDhTTOTTZ - JkVFPA-'^F fBtH: 4> 

a ..Vi--.ft.■....C.__ .D_E. 

, . H . . t BEACH FEEfllZ FUQZQZT 

......J Ltrigln dl££ 

......1 r *=« mVf 

**-* 

uj 

..1 T.f 

..._ § 10.4 

^---10 lie I 

.....n t.i 

+ * + i T ii to,? 

.....n 10 . i 

+ 1 

,...,16 “—“ 

]0-155i 

Figure 4-6. Starting the Beach Pebble Project. 

Cell El 6 contains the formula AVERAGE (B6 1314), the mean of the 
measurements. Cell D6 should contain the difference between the first 
measurement (in B6) and the mean But referring to the mean in B16 
would be a forward reference to another cell containing a formula! 
Repeating the average function in cell D6 (so the status area says 
CaKTBSTS **i 3 j 5 -AVemaue \& 6 B14 \ I avoids any problem. Remember that 
referring forward to an ordinary value cell is not against the rules, so 
with cells B6 to B14 it won't cause any problems. 
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Putting ViewSheet to Work 


Now the whole column of difference formulae can be written in by 
replication. This is a mixture of relative and absolute replication Cell 
Dti contains the formula 86 - average (86 814); the B6 part refers to the 
ceil to the left, relatively, but the AVERAGE section should always refer to 
the range B6 B14 absolutely, no matter where in the spreadsheet the 
formula is replicated to: 

io 

rrfliB - To? 

P€ - D7 flit 

Relative, NJo change 

BS - AVERAGE t B GBl4 |i 

R N H 

B is pressed when the first B6 is highlighted on the edit lino, and H when 
the second 86 and 814 are highlighted. That completes the second 
column in the model. 

The third column can be constructed in a similar way: first type In the 
top formula, then replicate to the rest of the column The column should 
contain the squares of the differences In column D, so the formula in ceil 
E6 is D6 A 2 , Note that while some of the differences are negative, their 
squares are all positive. Figure 4,7 shows all throe columns complete 
Note also the window definition has been edited to change the number 
format to DiRVt and widen the columns to nine characters, making the 
display neater 
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Figure 4.7 The three columns complete. 
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The final touches can be added to this model, by adding the three 
formulae In celts Fib Lo E IS. The variance formula in £16 is the sum of 
the squared differences, Eft E14, The standard deviation in E17 is the 
square root of the variance, 5QR (El 6). The coefficient of variation is the 
standard deviation expressed as a percentage of the mean, so the 
formula in El 8 is E17 / Bib * 10D. In the example, the coefficient is 
i 1.7%. At tills point in the exercise save the model, perhaps using the 
file name 'beach'. 

Recalculation Mode 

If I he model gets realty large, then each time a new value is put in, thrice 
pulsing dots may be seen in the upper left comer of the screen. This 
shows that ViewSheet is working, recalculating the whole model. With 
a really big sheet, this may take up to five seconds. 

Normally ViewSheet recalculates the entire sheet automatically every 
time a cell 13 changed This can make the process of entering data 
tedious and unnecessarily slow, because of the wait while a large model 
is being reworked. Automatic recalculation can be switched off by 
pressing KFCALCtJLArfi mode Occv SHIFT-10). The flag in lhe top left 
corner changes from V fur automatic to V for manual, and now data 
can be entered into a slot without any noticeable working delay 

I bis of course means that the model will not necessarily display the 
latest up-to-date cell contents, because if a cell is changed, then the 
effects will not ripple across the model. They only do this when the 
model is recalculated. The whole model can be recalculated at any time, 
by pressing SHI FT-17, HECaLCULATE. This brings all cells up to date. 

Automatic recalculation can he restored by a second press of SHIFT-10. 

Extending the Pebble Model 

If lhe grovel ond sond samples frnm olher parts of the beach are also 
required on the model r then all the formulae and labels can be copied 
across (relatively) to other parts of the spreadsheet, say to columns A A 
to AE, Then just type in the new measurements and the work is done! 
Room for extra measurements cun he created by inserting extra rows- 
LJut remember, the space will be inserted into columns A to E too! For 
this reason, if (hero are different numbers of items in each sample, then 
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replication of the labels and formulae should be downwards, towards 
A100 and El00 instead of across to columns AA and AE. 

I f a new area has been copied, and there is top much room, then delete 
rows so that the blanks do not interfere with the average Junction. 

Another way to go about this is to use a separate mode] for each sample; 
fond the tiHAt i i' -heel, and delete the data in cells B6 to B14 Replication 
of a blank cell is the quickest way of doing this; cell A1 Is blank, so; 

to 

From - TO? 

JU - 06 BU 

Now the model contains no data, but all the formulae are still there, 
ready and w aiting. Now save the model using a different name, 
perhaps t^trmask' This model without data can be loaded in each time 
a standard deviation is needed; only the new data need be typed In and 
the name changed again. This ty pe of sheet withou t data but containing 
fiormulae is often called a 

Doing Business with Viewsheet 

A spreadsheet is the ideal tool to help With laying out columns of 
figures. Perhaps the commonest example is when a budget has to be 
prepared Several sub-costs have to be totalled on a product or 
functional basis All the revenue has to be estimated from projected 
sales and prices. 

The process of setting out such a model is akin to the Pebble Project, A 
typical layout sketch is shown in figure 4.8, which shows a plan for a 
group of similar products, say a range of books. The areas where data 
has tq be entered into the model are shown, together with descriptions 
of the necessary formulae. Most of the formulae simply multiply or sunt 
other ceils. For example, the expected revenue from one particular 
product is the unit price of the product multiplied by the number of units 
that should be sold. The total expected revenue is the sum of the 
expected revenue for each product. 

A more complex formula is that for the unit selling cost of a product - 
the cost of selling (not manufacturing) one book- This is made up of the 
cost of promotion of the book title, plus the cost of distribution for that 
book. In the model, the distribution costs are not known for individual 
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titles; only the total spending on distribution is used Therefore each 
title bears a proportion of the total cost of distribution, according to the 
proportion of total book sales it accounts for. A typical formula fora 
title in row 10 might be A4 * jcwrc? cnw+ eio. 
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Figure 4.S. Layout for a budget planning model. 
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Taking Account 

Another type of spreadsheet application is laying out simple accounts. 
The example given is a manufacturing account, which calculates the 
cost to a Company of making things to sell. The cost of selling the 
finished items and the income received from their sale are not included; 
those appear on the trading account. 

Although It looks complex, the manufacturing account shown in 
figure 4.9 Ls Fairly simple. The hard work is identifying which costs 
should appear on the sheet, and that may be a job for an accountant 
Once a list of costs has been agreed upon, they are totalled up 

At various stages, adjustments are made to lake into account the 
difference in stocking levels between the start and end of the year. For 
example adding in the value of stock brought forward from last year 
and subtracting the value carried into next year. The cost is frequently 
sub-tctailed, to give the total material cost for example. Overheads are 
Li$fcd separately in this model, only the total is carried Into the main 
column; the formula held in cell C2b is 019 B2S. 
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Pulling ViewSheet to Work 
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Figure 4.9. Man is factu ring account. 

Editing the Screen Window 

In figure 4.9, the screen window has been redefined in give a narrower 
left-hand border, by reducing the border width (Bw) to four. Each of the 
three columns (Cw) has been widened to 22 characters, to leave enough 
room for the text in column A. Finally, the number format for the whole 
window has been set to EWKB, so any fractions are rounded to whole 
numbers and minus numbers are shown in brackets, as they often are in 
proper accounts. The new window definition is also shown in the 
Figure, in the status area. Once the display is correct, save the model 
uping a name like 'GADGET- 


( 
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The Printer Window 

The PRINT command makes use of a window' known as PC in exactly the 
.same way as the screen uses window zero. So the way a model prints 
can be changed by editing the printer window' definition 

To print nn paper exactly what is shown on the screen* this printer 
w indow definition PC has to tally with the screen window zero. The 
easiest way to do this is to get a copy of the current screen window 
definition onto the Edit line by pressing 1 1 in the usual way: 

fl 

Window? 

G 

Hi TafiL BOtR POS CM BW Fmt Opt 

Q JU C2fi 22 4 DOR! 

Edit the window number Wi from zero to F0 r and press RETURN This 
method can be used any time when the printer window should exactly 
duplicate the screen window: 

Hi TopL BotR Poa Cm E3w Fut Opt 

PO A1 C26 22 4 D£S3 

This technique is adequate for printing the contents of the 'HOUSE' and 
‘m \CH J models, but the 'GADGET sheet is too large to be shown on¬ 
screen all at once. Like the screen, a printer is of fixed width. Only three 
columns of 'GADGET can be shown on an S0-column primer, four 
columns each of 22 characters would be loo wide However, a printer 
can print an unlimited number of tows, so the printer window can be 
edited like this* to include extra rows: 

rt 

Window? 

PO 

Hi TopL BotR, Poe Cm BW Ffflt Opt. 

PO kl C37 22 4 DGRB 

Only the BotR co-ordinate has changed. This makes the printer 
window much larger than the screen window. 

The whole model can be printed out by entering the PRINT command at 
the ' Command mode prompt The final hard copy should look like 
figure 4.9, though of course the stains area will not be printed at the 
head of the sheet. 
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On-Screen Presentation 

Imagine using, a telescope to study a distant hillside. The single 
farmstead can easily be seen and each of its buildings, If a new town 
were built on the hill, the telescope would show only a few of the 
houses. Of course, moving the telescope, turning it left or right, up or 
down, would allow any group of buildings to be studied, bul only a few 
at a time. 

fn ViewShcet, the screen is like a telescope offering a restricted view of 
part of the sheet. The telescope can be pointed at any part of the model 
but if the model grows, to be large and complicated, the overall plan of 
the sheet is hard to grasp. The important bits of the model can't all be 
on the screen at once. 

Multiple Screen Windows 

ViewSheet offers a sophisticated solution to this problem. H allows Ihe 
model to be viewed through up to 10 separate telescopes or windows, 
each of them pointed at a different part of the sheet. This is the 
meaning of the window number Wi in She window definition; the 
windows are numbered zero to nine. 

Window zero starts as the only window, and the view through it covers 
She whole screen. If window zero is shrunk to fill only a part of the 
screen, then there is room to use window one to look at another part of 
the model. This way, several of the most important bits of the model 
can be seen at once, even if they are at opposite ends of the spreadsheet. 

It's important to realise that a complicated multi-window arrangement 
can sometimes be more of a hindrance than a help. The separate 
windows slow down movement across the sheet Ifs often best to set 
up the sheet using the hill-screen window first, and then arrange the 
windows you want afterwards. 
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So what are they for then? Using different windows is the only way the 
column width can be varied in YievvShoet; the columns themselves are 
not under individual control. Also^ the windows can be arranged to 
show only w hat is necessary, for example, data and answer?- Alt those 
nasty columns of manipulation in between need not be shown in the 
final product- 

Working with windows is the most difficult bit of ViewSheet to grasp^ so 
don't worry if it seems difficult; everyone is foxed for a while. 

Planning Again 

It's a good idea to roughly plan out the display on paper first; sketch in 
the windows, number them and name the cells ai each comer of each 
w indow. Without doing this, it is very difficult to visualise the final 
display as it is being created. 

There ate a couple of points to note when planning a multi-window 
layout- The first is that the total width of the windows shown on the 
screen can't exceed 79 characters, including the widths of the dotted 
borders, Remember too that ViewShecl spaces all the columns within 
each window' one character apart, and spaces the windows one apart- 
Therefore two windows each with three columns all of width seven, 
take up 4S characters, not 42, plus the width of the borders Similarly, a 
single blank line is left between windows down the screen, and this has 
to be allowed for when counting the total number of lines in a display. 

The sketch must take into account the screen mode; windowed displays 
set up for one screen mode? can't be used in another, Modes 0 and 3 are 
generally the most useful, because they display the largest number of 
cells across the screen. OverView uses the *w rpii command to increase 
the width to up to 1G& characters across the screen. This can be useful 
when setting up windowed displays, but that display layout can't then 
be used on machines without OverView, 

Figure 5,1 shows a sketch that might he used with I he T.AUcrr 1 
manufacturing account model from Chapter Four* The most important 
point to note is that only the first column needs to be wide as it contains 
text describing the account entries - the two remaining columns are only 
numbers, and so the can be much narrower, 
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column A 

I 


B C 


Figure 5,1. Sketched layout for the ^GADGET model 

Then? are four windows shown on the sketch in figure 54* The intention 
is that any working on the sheet will be done in the lower two windows, 
while the top two always remain fixed on screen, at the top of the 
columns to show the headings. Of course, proper column headings 
could he used, hut for long labels or descriptions they can be clumsy. 

Editing Window 0 

The first task in getting up any multi-window display is shrinking the 
main window to allow room for other windows, l oad the 'GADGET 
model and change to the chosen mode by using the MODS command: 

MODE 3 

Changing mode, or loading the model in the wrong screen mode always 
resets the windows to their normal default state. Window zero fills the 
entire screen with columns seven characters wide, that is column A In 
column | in mode 3. 

To change window zero to the size shown in the sketch, the window 
definition must be edited. This is achieved by pressing the Edit WINDOW 
function {key til then enter 'CT at the 'Hindu*?' prompt The normal, or 
default, window zero definition in mode 3 looks like this: 

fl 

Window? 

0 

Wi TQpL BefcR pos Cw Bw Fffit Opt 

0 M 11 * 1 7 FF4t 
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Cw is the width of cells shown in the window, Bw is the width of the 
dotted left border. Fmt controls the display format of values in the cells 

TnpL and RotR list the cells at the top-left and bottom-right of the 
window; this controls both the number of rows and columns shown on 
the screen, and the section of the sheet that is shown. If TopL and RotR 
were changed from Al and 119 to j 1 and RI9 respectively, the screen 
would show the same number of cells, but from a different area of the 
spreadsheet. To shrink the area of screen covered by the window, Botfi 
could be edited to A5: 

Wi TopL BatH Fqs Cw Bv Fjut Opt 

G M A5 30 7 D0HH 

The window* would show only five cells, in the top-left comer of the 
screen. Hie window should show the title labels of the sheet but just 
like the full screen window, the tiny window can be scrolled to show any 
area of the sheet. Try it, but to avoid confusion remember to go back to 
cell Al before adding a second window. 

Adding a Second Window 

The reduced size of window zero leaves room for another window. To 
add the second, edit window one: 

fl 

Window? 

1 

W:| TopL DOER POS CW Fmt Opt 

1 Kl Al 0 Q FFtt C 

The final 'O' under Opt indicates the window is off; deleting theO 
switches the window on. Alter the definition like this; 

HI TdpL Bat ft Po-S Cw Bw Frit Opt 

1 61 C5 10 ID 4 BOPS 

Note that the TopL and EotR cells have been changed, so that the 
window displays cells adjacent to those in window zero, The other new 
bit is the Pos J R0\ This shows the window should be displayed to the 
right of window Zero. The other possibility is- ' W; then window one 
would be shown bdow window zero, The position must always refer to 
a lower-numbered window, So window one must always refer to 
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window zero, whereas window three could refer to any of windows 
zero, one or two. 

When RETURN has been pressed, window one is displayed alongside the 
new, smaller window zero. The dotted borders make it dear where the 
edges of each window are, and the cell cursor is visible in window zero. 
Try moving the cell cursor around within the window; the window 
scrolls fust like it did when it covered the whole screen, without 
affecting the other window. At any time, the cell cursor can he switched 
to the Other window by pressing the function key 12, which is marked 
NEXT WINDOW tm the keyStrip. 

Opt can be used to switch off ihe window (with OL and it can also 
switch off the dotted borders at the top and left-hand sides. T removes 
the dotted line across the top of the columns and S removes the left 
border. T5 removes both, but this makes it impossible to tell which cell 
Ls which, because to add to the confusion the column and row names are 
removed too! However, cell names like CIO can still be used in formulae 
by pointing with 1 he sheet cursor and pressing SHIFT-COPY. Turn off 
just the side border for window one; 

Wi TopL BqtR PCs Gw Bw Fmt Opt 

1 Bl C5 HD 10 4 DOHA S 

The sheet should now look like figure *>-2- Note that with the increased 
width allowed for column A in window one, the whole of the text in cells 
A1 to A3 can now be seen. Previously* only the first 22 characters of the 
text could be shown. Now there is room for 3D characters, because less 
spate is taken up by columns B and C. 
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Figure 5-2. The 'CaDCETT model through two windows. 
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A Four Window Display 

The lower two windows in the layout sketch in figure 3.1 can be added in 
the same way as window one. The window definitions are as follows 
for window' Hvu: 

Wi TopL BotB P&S Cw Bw Flat Opt 

2 A6 A 13 SO 30 4 DC'RS VT 

and for window three: 

W1 TopL BatR Pas Cw Bw Fmt Opt 

3 Bfi Cl! Hi LO t DORS VK 

Nate window tw T o must be positioned below window zero. Window 
three could equally well be Wlow window one, or to the right of 
window two- Once these have been set up, the sheet should look like 
figure 53, 

There is one new feature in these last two window definitions, 'V* is set 
under Opt. This V stands for vertical ncroHing* and means that when 
the windo w with the cell cursor scrolls vertically, all the others with V 
set also scroll to keep in step. This keeps the text in column A in line with 
the right figures in columns B and C. 
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Figure 53, The completed lour-window 'GADGET' display. 
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T( & possible to set “IF under Opt too, this links together windows that 
scroll horizontally- One common layout b shown in figure 5-4, with the 
11 and V options set for various windows. While working in window 
three, the text headings in windows one and two keep in step whichever 
way window' three is moved, Windows two and three are linked 
vertically, windows one and three horizontally. Figure 5.4 also shows 
the range of S and T options, and the way they affect the top and side 
borders. 



Window 2 Window a 


Figure 54. A common four window scrolling scheme. 

When working on a sheet like this, it's usually most convenient to have 
the cell cursor In the largest window - in this case window three. 
Sometimes It is necessary to go to another window, And the next 
window function (key 12) should be used for this. It cycles through the 
active windows; press this key once to go from window zero to one, 
then again to go from one to two, then two to three, then back to one 
again and so on. 

Of course, any of the window s can be strolled to bring any individual 
cell into view. However, H r S seldom just one cell that needs to be looked 
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at, and the window may not be the right shape to show a]I of the area of 
interest. Using the next WINDOW function key is usually better. 

Saving and Loading Window Schemes 

There is a problem with this linked scrolling. If one linked window 
reaches the edge of the shed (ie, a cell in row 1 or column A is displayed) 
then it can't scroll any more. When this happens, the other windows it is 
Jinked to can continue to scroll. The result is that the w indows can get 
out of step with each other. 

The slow way to get them back in step with each other is to edit the 
window definition's TopL and BotR entries back to what they were 
originally. The quick way is to reload those definitions from a file on 
disc or (ape. Of course, before they can be loaded, they must have been 
saved first- The lesson is that once the windows are right, save the 
definitions at once- The SAVE command accomplishes |his, but there is a 
better way. 

T he complete set of screen and printer window definitions can be saved 
to disc or tape by using the sw command- Press ESCAPE to go to 
Command mode, then type: 

£W CKitidov -tiarae> 

where <window-name> is an appropriate filename. 

Later on, if the windows get out of atop, the definitions can be reloaded 
using a similar command LW: 

LW < window-najue^ 

Another result of LW is that ft also resets the screen mode to whatever it 
was when the windows were saved. Loading the whole model with 
toad doesn't do this; it just forgets the windows if the screen is in the 
wrong mode. 

Tape; The window filename can be up to If) characters long. Try 

to give the file a name that shows it is a set of window 
definitions, "CadCet-iaT forexample. 

Discj The filename may have up to seven characters, plus drive 

and directory name if necessary It is sensible to keep all 
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window files in a separate directory R so they are distinct 
from the model files (kept in directory M). The window file 
could be called TGADGET' perhaps, The reason for using P 
(for parte) is that ViewSpell uses W (for words, 
presumably) to store ite dictionary files, W (for window) 
could be used, but would be very confusing, 

ADFS, Net; Directory and filenames may be up to 10 characters long. 

Keeping the window files in a directory separate from the 
model Files is good. If the models are in the current 
directory VSHEET, then a sub-directory called 
vsi Em ,widows is probably best so (he window file could 
be called Ttfi n DOW s, gadget" . Of course, the windows sub¬ 
directory has to be created with the command *€DIK before 
use. 

It is important to realise that load and save deal with the whole model, 
including the window definitions, whereas LW and SW deal with ju&t the 
window definitions. If only £W Is used, the model itself isn't saved! 

Chameleon Colours 

A final aspect of on-screen presentation is the choice of colours for the 
display- In mode 7. the colours can't be changed, but in modes 0 to 6, any 
of the hbc; micro's colours can be used, With a colour monitor or TV, the 
real colours are shown; cm monochrome monitors and TVs, various 
shades of grey are displayed. 

The stark white on black display can be improved by addmg a coloured 
background to the sheet The colours can be changed as follows; make 
sure ViewSheet is in Command mode, then hold down CTRL and press: 

504 0 P Q 

This changes the background colour to a dark blue and is equivalent to 
the BASEC language statement, vdb 15,0,4,0.0,5. The foreground can 
be coloured in just the same way. 11 old down CTRL and type- 

s73050 

This makes the text yellow* 
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In these example the first CTRL-3 is always the same. The second 
character can W CTRL-0 to change the background, or CTRL-7 for the 
text colour The third character indicates (he colour to change to as 
shown belowi 


CTRL-0 
CTRL-1 
CTRL-2 
CTRL-3 
CTRL-4 

cm-5 
CTRL-6 
CTRL-7 

The final three keystrokes are always CTRL-0, Generally the most 
legible and restful colour combinations are white, yellow or light blue on 
a dark blue background. Dark blue on a light blue background works 
well, bul not in modes 3 or 6 because of the black bars between ihe lines 
of text. 

These colours are not saved in the file with the model or window data, 
but have to be set every' time the sheet is loaded, or whenever the screen 
mode is changed. 

Looking Good on Paper 

Chapter 4 introduced the idea of Ihe printer window. In just the same 
way that multiple screen windows can be sel up, several different 
printer windows can be set up too, This allows the hard copy to have 
many of the features of the screen layout, with varied column and 
border widths, just as on Ihe screen, only (he most important selected 
parts of the model need be shown. 

The printer w indows also allow some extra features First, the 
maximum width of the windows may add up to as many as 255 
characters, printer allowing Second, the contents of individual 
windows may be printed out in bold face, or underlined. 


black 

red 

green 

yellow 

dark blue 

pink 

light blue 
white 
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Printing the Screen Windows 

Copying the layout of the screen windows on paper is very 
straightforward, just an extension of the technique used earlier to copy 
the definition of screen window zero into prinler window zero. Once 
again using the 'GADGET" model - with four windows active on screen - 
copy screen window zero into printer window PO. Window one also has 
to be edited into the Pi definition, window two into F2 and window 
three into P3. 

Start by editing window zero: 

ft 

Window? 

0 


Wi TepL 

B*tR 

PC'S Drf 

0w Fenc 

Opt 

q ai 

A5 

30- 

4 BORIS 


Change this to; 





Wi TopL 

BOtR 

POS CW 

0W Fttt 

Opt 

PG At 

15 

ID 

4 DDftB 

TS 

Similarly, window PI reproduces window nne: 

Wi TnpL 

BatR 

!'ss CW 

Et» Fmt 

Qpt 

Fi &■ 

C5 

Mi 10 

< DDRil 

TS 


Note that for both these windows, both the top and side borders are 
suppressed by setting options T and S. Obviously, there is no need to set 
the scrolling options H and V for printer windows; il they are set, then 
ViewSheet ignores them, 

The two lower printer windows can be set in the same way* Remember 
that they both need to extend further down the sheet to row 3S t so that 
the whole model is printed out: 


Wi TOpL 

BetR 

P*3 CM 

Bw 

Fflit 

'-PI¬ 

P 2 Ah 

A3B 

00 30 

4 

SDRS 

TS 

and window three: 

Hi TppL 

BotR 

Pus Qw 

Bw 

Fmt 

Opt 

PI U 

cn 

R? 10 

4 

DORU 

TS 


Again, all the borders are switched off to help tidy up the printout. 

( 

( 
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With this multi-window arrangement, it is worth cheeking the way that 
the model will be printed, before committing it to paper. Like view, 
ViewSheet has a SCREEN command to do this. Press ESCAPE to return to 
Command mode and at the prompt, type: 

SCREEN 

The model will be displayed on screen, using the printer windows*. A 
check can he made and corrections done, Finally, if the printer 
windows ore right save all the window definitions with the 5 W 
command. Then ihc model can* be printed; 

PRINT 

The final printout should look like figure 5.5, 


3SJLL1-TIKE: LT9. 

Kami End*^ MCmh Afire 1 14#? 



t 

£ 

I7.H HATBUAL5 

Cjjtfiung E-LQCt 

PurcbjBoa 


UMQ 

TlfiClQ 

Lm*& ClMing titoclt 


94110 

[HQQ] 

TTTTlL HfcTZJUAL ODSTfl 
? induct ion 


Tina 

J710G 

pm« ffiacccnw oasr 


ill130 

tacOilrva 

PackagLivj Katoi'l* 1* 

F*«Q^y a-** 

1 n i L- r & ri 

Services 

Ani*l31 1 *iry Wjnjrf*o 

Aiic-iIlLftry 

PiiiW DtpfKl«Ue*l 
rixtu24> i mit^P 

3*OQ 

itso 

iiltfc] 

J3 DO 
I1M 
33D* 

3 3DDE3 
1200 
ito 

71700 

Ijb ■ a Mork Ir, Px--yre*? 


3*5510 

riJiai 

“J.T53 MifflUjCMOU CMTS 

L4isf Fuiribad Stock 


mS2 90 
ill a 501 

□EEt Of KCCB TO 

TRUHW ACCOUNT 


17Q440 


Figure 55. Printout of the complete GADGET model, 

Of course, the printer windows need not mirror the screen windows at 
all, they can be completely different if necessary Remember that when 
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the SW command is used the printer windows ore saved too. And 
although changing screen mode resets all the screen windows to the 
default single full-screen window, the printer windows axe left 
unaffected oy ViewSheet, 

Wider Layouts 

The printer windows can be up to 255 characters across overall, 
although an individual window can't he more that 253 characters wide. 
The screen is a maximum of 80 characters wide, or 106 characters with 
OverView. If a wide-carriage printer is available, then it may be useful 
to arrange the printer windows so that their overall width exceeds the 
width of the screen, 

Bui be wary Of doing tliis without a wide printer, ft is difficult to add up 
the total width of the windows in a multi-window scheme. The print¬ 
out will be spoilt if the printer windows' lota] width is greater than the 
printer can deal with. In this case, the last characters at the end of every 
line 'wrap around' and print on the next line of the paper. Thus each 
row of the model is spread over two lines of paper and the neat tabular 
layout is ruined The page preview program described next checks 
Whether the printer windows are too wide for the printer's capabilities. 
The listing is at the end of this chapter on page 67, 

If an extra wide layout is set up, the 5CREEM command will no longer 
show a sensible picture of the sheet before printing it. This can happen 
even with an 50-column printer, if the size of the model and lack of 
memory make it necessary to work in a 40-column screen mode. The 
PAGE program may be used as a check in this case too. 

Previewing the Page 

The PAGE program at the end of the ehaper first appeared in the July 
1987 issue of Acorn User magazine. 

tn order to use PAGE, type in the BASIC program listing starting on page 
67 and save it. Don't use the filename 'PAGE': use 'PACEsrc" or something 
similar. Remember to go into basic first. 

The constant 'gxri should be set to TRUE m line 60 if the Acorn Graphics 
Extension ROM (GXR) is fitted to the micro, or if it Is a Master scries 
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computer (where the GXR is part of the operating system). If the final 
page preview program is to do used on machines without the ROM, then 
leave *g\f as FAISR 

After saving the BASIC program, run it. If there are no errors, the 
program will assemble and automatically save the machine code file 
'PAGE'. This file is a view family printer driver. In ViewSheet Command 
mode, it can be loaded by typing; 

PAHTCEft PkGt 

Once loaded, PAGE will work in any of the graphics modes 0,1,4 or 5, on 
a BBC B, or their shadow equivalents on a BBC E3+, Master or Compact 
(modes 128,129,132,133), If the display mode is either 16 colour, text- 
only or Leletext (modes 2 r 3,6 or 7,130, 131, 134 or 135), then it must be 
changed to one of the graphics modes; it doesn't matter which one. 
Using mode 3 is usual when working on a model so mode 4 is probably 
the most convenient to change to; 

Moke 4 

Now the model can be previewed, by using the print command as 
normal Type in; 

?MHT 

Page draw's the outline of a piece of 'paper 1 on the screen, then adds the 
words and numbers in the form of small black bars rather than 
individual characters. Obviously the model can't be read, but the 
overall proportions oi the paper page can be judged. It is possible to 
check the window* layout without actually printing out a copy. If the 
windows are loo wide to fit the paper, this is dearly shown on-screen. 

With PAGE, when one piece of paper is filled up, the program pauses; 
move on to the next sheet by pressing the space bar when the ‘Next 
page../ prompt is displayed. If this happens, it means that ViewSheet 
can't fit the model onto a single sheet Because ViewSheet doesn't have 
any facility for pausing during printing (there is no equivalent of VIEW'S 
SHEETS command), this show's that the model can only be printed on 
continuous stationery. 

Pressing ESCAPE at any time returns the PAGE program safely to 
ViewSheet Command "mode. 
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By using PAGE to preview the layout of the printer windows, these can 
be checked before they are printed out. If wrong* they can be edited, and 
PACE used again. Once the windows are correct, fagf can be removed, 
and ViewSheet can be prepared for normal printing, by entering: 

PRINTER 

Matching PAGE to Dif ferent Stationery 

As it stands, FACE will display text as it would appear in a pica (ID 
characters per inch) font on A4 paper. Check the program out by 
previewing a multi-window scheme less than 80 columns wide, for 
example the four window layout used for the 'GADGET model. 

When the routine is working properly, versions of page may quite easily 
be customised for w ider printers, different stationery or for another 
type pitch. To assemble a new version, changes can be made to the 
values given to the constants Jim’s and chars in lines 70 and SO. These 
denote the number of lines per page and the number of characters 
across the whole width of tne paper. 

As an example, A4 paper used sideways (or landscape && it is called; 
l] pright Ls portrait) is about 11.7-inches across by 8-25-inches down. 

That leaves room on the sheet for 117 characters across the paper (11,7- 
iriches at 10 characters per inch), and 49 lines down the paper (8-25- 
inches at six lines per inch). Thus, lines 70 and 80 could be changed to. 

70 lines - 49 
30 eftars = 117 

The dimensions of other common stationery are given in figure 5-6. The 
maximum si^e the screen can accommodate is 82 lines of 160 characters. 
If the paper is too big, the program still works but only the central 
portion of the paper is shown. 
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Lines 


95 x 11 cont. 66 
143 x 11 cant 66 
A5 (portrait) 50 
A5 (landscape) 35 
A 4 fportrait) 70 
A4 (landscape) 495 
A3 (portrait) 99 
A3 (landscape) 70 


Width in Chars 


pica 

elite 

85 

102 

135 

162 

59 

70 

82 

99 

82 

99 

117 

140 

117 

140 

165 

198 


Table assumes inch Hint spacing and CpbcaS or Inch (oLiteJ character spacing. 


Figure 5.6, Common paper sizes. 

When possible, it is also a good idea to incorporate some reference to 
the stationary sifce and pi ten in the filename, for example V\4Lpica'. This 
file name can be changed in line 90 of the program. 

Only lines 60, 70,80 and 90 should ever require alteration when making 
up a new version of PAGE, 

i ? AC£ can also be used to check whether a set of printer windows are too 
wide for the printer. If the printer Ls capable of printing only 80 
characters across, then make up a version of FACE with chars set to SO: 

g{] ohRTR - SO 

It a model is previewed with this driver, then any text that goes off the 
'paper" on screen would also wrap around on the printer and spoil the 
neat columnar layout. 

Technical Features of PAGE 

Whichever screen mode face Ls used in, a screen page appears to have 
about the same proportions as the final sheet of paper- fn fact, the 
picture is drawn slightly too wide, as the ratio of height to width of a 
cell (one character by one line) is 15 to 1 on screen, but 1.6? to 1 for a 
standard printer in pica mode. The page width is further exaggerated 
in elite or condensed mode, but in practice the distortion is acceptable. 


6b 


Using The Model 


( 

c 

c 

( 

( 

< 

( 

( 

( 

< 

( 

c 


ff the gxr constant mentioned earlier is TRUE, then the program draws 
each page faster. This is because the rectangle drawing routines (PLOT 
codes % to 103) can replace more complex groups of lines and triangles 
It is worth noting that where possible, face draws by inverting the 
present screen colour So whatever combination of text and graphic 
foreground and background colours is used, both the paper and the 
characters on it will be visible. 

This inverting of screen cdouis is the reason PACE cannot work with 
mode 2. \n other graphics modes, the inverse of the background colour 
is the foreground, but in mode 2* inverting the background results in a 
flashing colour. The resulting display is unusable, and so (he pace 
driver checks for mode 2 along w ith the non-graphics modes. 

Program Listing 5,1 


10 

20 

10 

4f) 

50 

60 

70 

SO 

so 

IQG 

110 

120 

130 

140 

150 

160 

17Q 

180 

ISO 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 

310 


FEM VIEW PAGE driver source 
REM by Graham Beil 
REM Eg r E/B+;m/C/E - VIEW family 
W5M id 1SB7 Acorn User 

gitr = FALSE 
Linss - 10 
chars = 62 
name$ = "FACE" 

REM alter for different stationery * default is 
AA Fica 

► 

□fibyte = AFFF4 
ogwreh. = &FFEE 
osrdch - iFPEO 

DIM code AFF 
FOR II = 0 TO fiFF 
H?qDde = □ 

NEXT 

off = code - 4400 

FOR pass - D TO 1 STEP 3 
v\ = code 
( OFT PASS 

JMP □ lit put - off 
JMF newpq - pff 

RTS 

BRK 

BFtf 

nrs 
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320 + char 

BRK 



330 .line 

BRF 



340 

RTS 



330 : 




3$0 .error 

BRK 



310 

OPT 

FHequb 

(12*1 

330 

OPT 

FNdquS 

("Bed made 

330 

BRK 



400 3 




410 .v*s L t 

LDX 

*4 


420 

JSR 

text - 

off 

430 

JSR 

oardch 


440 . newpg 

L BA 

1135 


4 50 

JSR 

osfoyte 


4 SO 

CP Y 

12 


410 

BCC 

raadeok 


400 

CPY 

14 


430 

BCC 

error 


500 

CPY 

*6 


510 

BCS 

error 


520 . modeok. 

jDX 

*0 


530 

STX 

line - 

Off 

540 .n-evin 

JSB 

text - 

off 

550 

STX 

count - off 

560 

STX 

count + L - Off 

570 

RTS 



500 : 




530 .text 

LBY 

data - 

off, X 

600 

uDA 

data * 

1 - of file 

010 

SEC 



620 

SBC 

data - 

Off r X 

630 

TAX 



640 -loop 

LEA 

data - 

offj ¥ 

650 

JSE 

ostrrch 


660 

im 



670 

BEX 



€60 

EMP. 

loop 


690 

RTS 



700 * 




710 output 

ST* 

char - 

off 

720 

TXA 



730 

PHft 



740 

TYA 



750 

PKA 



760 

U>A 

line - 

Off 

770 

CMP 

lllnes 


760 

BCC 

notpg 


7 90 

JSR 

Wait - 

off 

000 t nctpg 

l+B-A 

char - 

off 

010 

BMJ 

return 


020 

LDX 

#1 


630 

CMP 

113 


040 

BNF 

not In 
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050 



r.ewln - Oft 


BSD 


INC 

line - off 


B70 


JMP 

return - off 


B30 

1 




ago 


tNX 



90 Q 


CMP 

132 


310 


HNE 

print 


320 


tNX 



330 

.print 

JSR 

te*£ - off 


940 


SEC 



950 


EDA 

count - Off 


960 


SBC 

IS 


910 


ST A 

count - off 


900 


BCS 

return 


930 


DEC 

count + 1 - off 


100 0 

.return 

FLA 



1010 


TM 



1020 


FLA 



1030 


TAX 



104D 


WA 

char - Off 


1050 


RTS 



1060 

4 




1070 

.fiats 

OPT 

FNecfuh (string - 

data) 

io a o 


DPT 

FHequb (fltrinl - 


1090 


OPT 

PNequb (atiin2 - 

data) 

non 


OPT 

FPTegub (string - 

data) 

mo 


OFT 

FNequb Utrin4 - 

dat aj 

1120 


OPT 

FMequb J S t r i ft 5 - 

data? 

1130 

: 




1140 

-strirtO 

OFT 

Fflvdu E26J 


1150 


OPT 

FKvdu ( FWcia r gxr t i 

J1 60 


OPT 

FKotig (54 0•chars 4 

■4,496 

1 1 70 


OFT 

FKplot (4, 0, 0> 


11 BO 


OPT 

FNpage (gacri 


1190 


OPT 

FNplnt<4p0, lines -12-5] 

1200 

. strip! 

OPT 

PNplot ( 0 , 0, -12J 

1210 

.string 

OPT 

FNdut(gxrl 


122 0 

.stein3 

OPT 

FNplpt (0 * Bj 0) 


1230 

.string 

OPT 

FNequa("Wext page--") 

124 0 

*shrin5 

PELS 



1250 

] 




I260 

count - 

strinl + 2 


I27fl NEXT 




1260 

: 




1200 

suml = 

0 



1500 

FOR II 

= Q TO 4FF 


1310 

suie! - . 

aunil 

+ llTcode 


1320 

NEXT 





1J4D 


= 70S AND 

rrhiirs = S3) THEN ^Kltrr "Assembler error - 
please check listing"*: END 


%w~* 
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1350 

136 0 
1370 

13 & 0 
1390 
I40Q 
! 41D 
I42G 
1410 
144 Q 
1450 
1460 
1470 

14 80 
1490 
1500 
1510 

15 £0 
1530 
154 0 
1550 
1550 
1570 
15&0 
1590 
LE0 0 
1610 
1620 
1630 
164 0 
1650 
166(1 
167 0 
160 0 
1690 
1700 
1710 
1.730 
173-Q 
1740 
1750 
1760 

1770 

1700 

17&0 

1000 

1&10 

1820 

I03Q 

1840 

1A50 

186(1 


FRQCUSCl! (" SAVE * * r.aifrfcO * " " * 5TR0- e + 
" +100 4DC 40D") 

END 


l 

DEP FKdct (graph isr!) 

IF graph!cl THEN GOTO 1460 
[ OPT pass 


OPT FHplnL 
OPT FNplat 
OPT FWplot 
OPT FHpldt 


(2, 7v 0J 
(0, -7, -7] 
12, 7, 0? 

1, TJ 


I = pact 

OPT pass 

OPT Fflfplot (5&, 7, -73 
OPT FWpiot t0, 1, 'If 


| = pats 


P&F fNpage (graphic)} 

IF graphic) THEN GOTO 15 BO 


1 - pass 


OPT pas s 
OPT Ftfplct 
OPT FWplot 
DPT FHpldt 

i 

OPT pass 
DPT FWplot 


pass 


t i t chars * 8 - t, Of 
(S3, 0, Linas -12-1) 
(65,chars* 0-1, llnfls # l2- 


1) 


(102 # cha rs * 0 ^ 1 r 1 i nss * 12 11 


+ 

PSF F!*c;s (graphic*? 

IF graphic) THEN = 12 ELSE = 16 

D£F FWtocal (graphic)? 

if graphic) THEN - *46Al ELSE - -l4A4 9 

* 

DEF FWvdu tcodE)) 

- FNegub (cc4el) 

DEF FWorig (x), y)j 

pass - FWequb (29i 

pass - Fttequw (K) AND 4FFFF3 

= FNifgirtr (yt AND GFFFF) 

: 

DEF FNplot (code), x%, y)f 
pass = FNegub (25} 

pass - PHequb (code)} 

pass = FNaqCV (Xl AND 4FFFF? 

= FNegui* (y) AND 4FFFF} 


DEF FNequb (byt&%J 
2P1 = byte* 

F) ^ F) + 1 
* pass 
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def F*aeq\w [wordI^ 

1BPQ ?PI = word* MOD 2 56 
1890 F%?1 - word! DIV £56 
i960 PI » F% * 2 
1910 = paas 
1920 ; 

19 SO DBF ENeqiis (ptfiagt) 
1940 SP% - string? 

1950 Pi = Ft 4 lew string? 
I960 - pass 
1970 ■ 

19BD DEF PRjOCdflCll [string?} 
1990 LOCAL XI, Yl 
2000 DIM X% *FF 
2030 ¥1 - XI DIV 256 
2021} S-XI - string? 

2030 CALL 4FFF7 
2040 ENDPROC 


Listing 5-1 FACE preview driver. 


( 






( 

c 

( 

< 


c: 

1 } 
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Printer Drivers and ViewSheet 

When the print comniand is used in VtewSheet, the text and numbers 
on the sheet are usually sent directly to the printer, Uking into account 
any printer window that arc active. This is straightforward, but it 
doesn't make good use of the capabilities of the printer Most printers 
have a bold font, and can underline characters; many can print in italics 
and in many other different styles as well 

Unfortunately, problems arise because different types of printer need 
different ciWre/ cad& to use these special bold and underlined effects. 
Control codes are the printers equivalent of VDU codes, and they can be 
used to change the style of the print For example, the control code 
known as F5C *E': in BASIC this could he sent to the printer using: 

VDU i, I, 2t, 1* hSC 11 E ■, 3 

On an Epson dot-matrix printer, these codes make the print style bold, 
but if senE to a Juki 6100 daisy-wheel printer, the text is underlinedf In 
fact, by far the majority of printers used with BBC micros are of the doP 
matrix type, and most of the modem ones are Epson-compatible (or 
nearly so). These arc considered the "standard' printer to use with the 
BBC micro. 

A further difficulty is that most printers do not have the same character 
set as the BBC micro: for example, what appears as a hash character ) 
on the keyboard and the screen, is often printed as a pound sign (Ek 

To overcome these problems, ViewSheet and other members of the 
VIEW family can be used with a printer driver. This is a program which 
manipulates the output from ViewSheet before sending it on to the 
printer. It also controls I he use of bold and underline effects. Highlight* 
are used to set the underline or bold type When printing, the text, 
numbers and highlights are sent to the printer driver, and from there on 
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to the printer. It is the printer driver's job to translate each highlight 
into the correct control codes required by the printer. 

Because different printers require different control codes, a unique 
printer driver is needed for each type of printer. 

Using a Printer Driver 

Anv primer driver that is suitable for use with VIEW Ls also suitable for 
use with YiewShect. If one is not available, the next section shows you 
how to create one. Alternatively, the program disc accompanying this 
book contains a simple driver for Epson-compatible printers. Once a 
suitable driver is available, then the driver must be loaded before 
starting to print anything out. In ViewSheet Command modes, enter: 

PRINTER FXI 

to load .1 driver called FX4', When it's been loaded, anything destined 
for the printer will be sent via the printer driver. Just use the FKTNT 
command as normal. 

ADFh, Net: Commonly, the driver is not in the current directory. It 

might be m a personal library directory for example, so 
the command could be: 

PRINTER L.MYLIBRARY. 

Net only: On a network, the driver might be in a public library in 

the main root directory instead. Hies could be accessed 
by using: 

PRINTER {.LIBRARY T 

& indicates the user root director}/, the one selected with 
*Dit S is the main root directory, of which library is 
usually a sub-directory The k feature is only available 
from Atom Level III orSJ Research Ecnnct network 
ftteservors 
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Assembling New Printer Drivers 

There are five standard drivers supplied in the Acorn Printer Driver 
Generator package: Viof for the Olivetti Spark Jet printer, 'FX+' for 
Epson fxsci and the many other Epson-compatible dot-matrix printers, 
'fUKT4' for the Juki 1600 daisy-wheel and 'facz' and J rLOi& for the Farit 
8105 and Ricoh Rowriter daisy-wheel printers. The Mister series 
Welcome disc contains a similar selection of standard driver?- The 'fxT 
driver is the equivalent of the 'EPSON' driver on the Master Compact 
Welcome disc, 

If the printer you use isn't included as standard, then the Acorn Printer 
Driver Generator can be used to create a new driver. Usually, ihe most 
difficult job is understanding the printer manuals 

The Printer Manual 

Many printer manuals are examples of the worst type of technical 
til era lure. They an? often (tauntingly large and difficult Lo understand. 
Many are badly translated (frequently from Japanese), and the 
programming examples are usually in Microsoft BASIC, which is a very 
different language from BBC bastc. Also, many printers have features so 
complicated that they are hardly ever used, 

To create a new printer driver, only a few features of the printer need 
be looked up in the manual. The important ones to look out for are 
listed below- 


reset printer 
set/cancel underline 
set/cancel emphasised mode 
select character set 

There is often a control code summary' in the manual, and this usually 
contains enough information* The codes in the summary might be listed 
in a variety of ways. To understand this, it is important to realise that 
there are two ways of refer! ng lo a single characters as a character 
{letter, number or punctuation) and by its ascf? code (which is the 
number actually Sent Eo the printer), tor example, the number nine 
(character '90 can be referred to as ASCII code o7, 
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Often, the Codes in the manual's summary are written nut something 
Like this: 


ESC @ 

IB 

ID 

27 

£4 

reset printer 

page 144 

KC 4 

IB 

34 

27 

52 

set italics 

page 68 

E9C-n 

IB 

IP G 

27 

IS n 

set/cancel underline 

page 72 


Each of the first three code columns gives the same information in A 
different form. The first might be termed mnemonic form, the second is 
in hexadecimal (numbers in base 16), the third in denary (ordinary base 
10 numbers). When using I ho Printer Driver Generator, the mnemonic 
in the easiest form to work with, but if programming the printer in BASIC 
the decimal form is more convenient. 

Most control code sequences begin with FSC, the code generated by the 
ESCAPE key, so they are often called escape sequences. The ESC 
mnemonic represents a special character fin fact ascii code 27) that teSta 
the printer to expect something special. The following code in the 
sequence nearly always represents an actual character. Even ESC 4 
means the character '4' (ASCII character 52), not ASCII code 4. 

The third bit of the underline sequence is listed as 'n'. This doesn't mean 
the character 'n' (ASCII code 110), but a number, or parameter value. 
What this number should be, can lie found by looking up the details of 
that particular control sequence; 

n^O. . cuds underlining 

n = 1 _begins underlining 

The parameter Is sent to the printer as an ascii code, so n = D means 
ASCII code 0, not the character TS' (which is ascii code 43), 

The Generator 

When the Printer Driver Generator Is run, it prompts you with a series 
of questions about what features you want in the new printer driver, 
and which control codes the printer requires to switch on and off each of 
these effects. These codes must be found in the relevant printer manual. 

Printer initialisation is usually necessary' with dot-matrix printers. The 
printer reset sequence (usually ESC @) is sometimes used to get rid of arty 
odd printer settings left over from previous programs. More often 
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though, a special code is needed to allow pound signs to be printed. Qn 
an Epson FXBti or Canon printer, pounds are unavailable until the escape 
sequence ESC I I is used; after this, code 6 prints a pound sign. 

To answer the printer initialisation question with ESC 11, enter the 
following at the prompts: 

Include printer Initialise!:inn? 

Y 

Give code sequence for initialising the printer : 
esc H i T i 

Notice how esc is entered as a mnemonic, the 1 is enclosed In quotes 
because it represents a character, but the ASCII code 1 is entered as a 
number and without quotes.If several of these sequences are needed, 
they can simply be Joined together, for example: 

SSC H 8* CSC 1 

Auto line-feed depends on the printer. The tiny dip switches Inside the 
printer are sometimes set so that printing RETURN (ASCII code 13) makes 
the paper feed up one line automatically Other printers are set so 
RETURN and a line-feed (ASCII code 10) must be printed separately One 
way of checking this out before running the Generator, is to enter: 

-rx $ to 

Make sure the printer Is connected, then press GTEL-B and type RETURN 
a few I imps. Finally press GTRl-C to switch the printer off again. Check 
whether the printer moved the paper up, and printed something like the 
following; 


=> 

■> 

•> 

If so, then the printer has automatic line-feed. If the printer has not 
moved the paper at all, but just printed one prompt perhaps a little 
darker than normal, then it has no automatic line-feed. 

The Generator asks whether the printer does line-feeds automatically. 
If still in doubt, try Y as this is most common. If all t he text is later 
printed on one line, then try again with the answer N. 
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Underlining is the effect given by highlight one, The bold effect is 
controlled by highlight two. The control codes for these effects should 
be entered first to switch the effect on, then to switch it off- Bold is 
often called double-strike or emphasised printing, it means the same* 
text Is printed twice to make the type darker. 

The dollar, hash and pound signs are often the source of difficulties, 

The Generator must be told the codes that print each one of these 
characters. One complication is that many dot-matrix printers now 
have more than one character set, and not all the characters are 
available in each set. There is no hash sign in the United Kingdom set 
on Epson printers Which set the printer uses is again controlled by the 
DP switches inside the printer. 

Overall, if the DIP switch settings can be changed, it's best to have the 
printer use the American character set. With the US set, most 
characters are printable, but this may make it difficult to print the 
pound. If a single code to print a pound sign can't be found (like A9CH 
code 6 on an Epson FXBO), then the following sequence might be useful; 

ESC -ft - 3 *#" JSSC *R U 0 

This allows an Epson ttXs.i printer to print a pound sign, by switching 
from the US character set to the UK set (esc R3J. printing a hash (which 
comes out as a pound sign, because there is no hash in the UK character 
set}, then switches back to the US set (ESC R U) Hash is printed as 
normal, because it lakes its usual place in the US character set- 

Conversely, the printer might be set up to use the UK characters, in 
which case a hash sign is difficult to print. The following codes are the¬ 
re verse of those above: 

ESC “ft* ESC "Fl H 1 

They print a hash by switching temporarily to the US set. To get a 
pound sign, a normal hash is used. 

None of the other features that the printer driver provides for VIEW can 
be used in ViewSheet. Since the output from a spreadsheet model is 
tabular, microspacing would ruin the neat layout. Italics, an alternative 
font, extra characters or exact spaces, subscripts and superscripts can’t 
be used, because they all require the highlights to be redefined or the use 
of extended highlight sequences, view uses the i IT edit command for 
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this, but ViewSheet doesn't have any equivalent. A Printer Driver 
Generator is also included on the disc accompanying VIEW: A Oahhmtd 
Guide* This is also suitable for use with ViewSheet. 

Line Spacing Problems 

Two of the most common printing problems an? that the text may be 
printed all on one line, ie, the printer never moves the paper up, or all 
the text is double line spaced 

If you are using a printer driver created with the Printer Driver 
Generator, then the driver is the source of the problems The wrong 
answer was given to the auto line-feed question- To remedv this,, 
rebuild the driver from scratch with the Printer Driver Generator, using 
the correct answer for the auto line-feed question. 

It you're not using a printer driver, then the following makes sure that 
the printer moves the paper up: 

*rx $ 

If the problem is double spacing, the following ensures that the paper 
moves up only one line at a time: 

*FX e 10 

Master series The computer can be configured so that +fx ft is 
unnecessary: 

*CO»FICEfltE MOIfiJJOftE 

has the same effect as a permanent *FX 6, and: 

‘CCNTKftTAE IGJffORE 10 

is like G 10. 

Whether or not the printer has auto line feed is controlled by a tiny 
switch, often called a DIP switch, inside or on the back of the printer. 
Changing the setting should be covered in the printer manual. Most 
UBC micro software assumes that the printer has auto line Teed- 


Printers and Drivers 


Highlights in Window Definitions 

So how are underline and bold actually Used? The highlight codes in 
ViewSheet are not placed directly onto [he sheet. Highlights one and 
two are inserted into the printer window definitions, as options one and 
two. Each highlight applies to all the cells in that window. En addition 
to the TS options to prevent the top and side borders from printing, this 
printer window definition has highlight one set: 

[A SWT-fM 
corrtlaT!Wel*rtOft 

Ml T<*it SraJi PoaCn TwtL Opt 
Pi IH H7 W 13 * FRH TSt 

Before use, the printer driver must be loaded with the PRINTER command 
Then the frist command may be used in the normal way, and the sheet 
is printed out as follows: 

Jttfaflaflll 

JangS 

Lake 

trait Und 

In exactly the same way, highlight two can be used to print out the 
window in bold face, or both highlights can be used together to print 
bold and underlined text 

As can be seen, ViewSheet only underlines the actual contents of the 
cells, and not the whole cell width. If; 

Jfltinsan 

is needed, then the cells on the sheet must be padded out with spaces to 
the correct length ViewSheet will underline the spaces. 

Sometimes when highlight one is set, short lines are printed where the 
cells should be blank. This happens because the cells on the sheet are not 
in fact blank; they contain a few r spaces, and the printer tries to 
underline the spaces. If the offending cell is checked by moving the cell 
cursor onto it, the status area will often say: 

LA iLOl-fc! n 
•SONTCWTS- 
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Cell Bft is not really empty. To clear this up, use the DELETE SLOT function 
(key SHIFT-t9). The status area changes to: 

x cLtff-lH 
coirreHTS-«pujMSFT 

and there are no spaces to underline. 

Viewing Figures 

Whatever method is used to print the model out, ViewSheetdoes not 
offer the degree of page layout flexibility Vtfw does. It can't set 
margins a! either side of the paper, can't leave space at the head and 
foot of each page nor automatically number pages. In fact, if 
continuous stationery is unavailable then any sheet spreading over 
more that a single piece of paper can prove difficult to print out. There 
is no easy way to make I he printer pause between sheets. 

Sometimes it would be useful to use a VfewSheet spreadsheet within a 
larger document, for example an account in a financial report or 
statistics in an experiment But ViewSheet can't be used to create text! 

The answer to both of these difficulties is to transfer the ViewSheet 
model into VIEW, Then the word processor can be used to incorporate 
the sheet and extra text into a larger vn-w file. When it is printed out, 
all the facilities of veew can be used to control the layout of each page. 
However, the spreadsheet file created with the Save command is not a 
lexl file, and it can't be read directly into VJEW. 

To create a text file that can be read by VIEW, a technique using *£POQL 
may be used- After setting up any printer window? necessary^ return to 
Command mode. Then to create the text file, type the following: 

* SPOOL *t£3t-filanikma> 

SCREEH 

•sreoi 

This technique has two disadvantages. First, the file contains a few 
extra lines of text which must be deleted once it is read into view. 

Second , the highlights attached to printer windows can't be transferred, 
and inserting them manually in VIEW can be tedious. To simplify the 
transfer of ViewSheet models with or wilhout highlights, into vmw, the 
Vsxfer program can be used. This program is known as a spooler. 
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The VSXFER Transfer Spooler 

To use the V 5 XFEH program, type in the BASIC program in listing I at the 
end of the chapter. Save the program using the filename 'vsxFsre^ 

Then run it, 

The program incorporates a routine to check the assembly language, 
and this has to be correct before the assembled spooler is saved 
automatically under the name J V5XFER*- This spooler pretends to be a 
ViewSheet printer driver, but instead of sending the sheet to the printer, 
It sends all the output to a file instead. 

To use VSXFER, load it with the printer command; 

PEtiKTER VSKFIR 

then PRINT the sheet, exactly as if □ printer were in use: 

FJtTUT 

The spooler program prompts fora name for the new text file: 

Spool filensure 1 RETURN 

Enter a name for the now text Hie, ViewSheet spools the model to that 
file, taking account nf the printer windows. 

If you need to interrupt the spooling process, then press ESCAPE, not 
BREAK. This ensures the spooler closes the spool file and hands back to 
ViewSheet gracefully. If BREAK is pressed, then the file may be left open, 
and this can cause difficulties later on. 

The spooled version of a model contains a text Translation' of the work 
that can be read or loaded directly into view, with every thing appearing 
in the file as it would on a printed copy, including any highlights. 

If the spooled file is to be read into the middle of a larger view document 
that uses extended highlights (sequences of several highlights used to 
control printer effects), then because ViewSheet can't be used with 
extended highlights, a little more work is needed. One option is to 
replace ail instances of highlight two fbold) with the equivalent 
extended highlight 
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This can only be done in VIEW version three or later, using the following 
vtew command; 

CHANGE ** ****** 1 2 RETURN 

Do this after placing markers one and two at the top and bottom of the 
spooled spreadsheet. In earlier versions of view, the extended highlight 
facility has to be switched off temporarily. Place the stored edit 
commands: 

HT 2 129 

and also; 


HT 2 130 

respectively at the top and bottom of the spooled spreadsheet, 

There is usually no need to worry about reformatting the text in VIEW, 
Providing that the top and side borders are removed (with T and S 
options in the printer window definition) Lt won't spoil the neat tabular 
layout of the spreadsheet. Each line of a borderless model spooled from 
VaewSheet starts w r ith a space, so they aren't affected by formal ting- 
The only real limitation is that VIEW can't use files with a line length 
greater than 132 characters,, so make sure the overall printer window 
width is less that that, 

A Modified ASCII Spooler 

It is possible to modify the vsxfer spooler so that it does not Include any 
highlights in the transferred file. This may be useful if a spreadsheet 
needs to be transferred into another word processor, such as Word wist? 
or Inter Word, which can't interpret the VIEW highlights. 

Listing 2 at the end of the chapter shows the changes that must be made 
to Listing 1 to create the new version of the spooler. Save the modified 
BASIC program using a filename like 'ASClsre', then run it. If all is well, 
then it wifi assemble and automatically save a new spooler called 
'ASCTT- In all respects, this resembles VSXFBJt, except that nn highlights 
are put in the new text file. 
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To use this spooler, load it as if it were a printer driven 

FRISTS JtSCII 

then use the PRINT command to print the spreadsheet, The spooler 
prompts for a filename for the new file, then the sheet is spooled into 
that file. The resulting pure text file can be loaded into almost any 
word processor, or even sent by electronic mail It contains no control 
codes or highlights, just ordinary text and carriage returns. 

Technical Details of VSXFER and ASCII 

These two programs first appeared in Acora User magazine, in July 
198fi Both programs are compatible with cassette, disc or network 
filing systems, on any Acorn machine that can run ViewSheet. 

H is worth noting that the highlights in any ViewSheet model when 
printed, send the codes 128 and 129 to the printer driver just as they do 
by default in VIEW. Of course, these codes can be redefined In VIEW 
using the HI edit command, but this is impossible in ViewSheet. When 
stored in a view file, these highlights are not stored as codes 128 and 129 
or their redefined values, but always as codes 28 and 29, So to make the 
model readable by view; the spooler translates the highlight code one 
from 128 to 28 and anything above 128 to 29, 

The spooler programs both deal with any errors or ESCAPE by closing 
the text file and handing control back to ViewSheet in an orderly 
manner. If break is pressed accidentally whilst either spooler programs 
is working, then with many filing systems, the text file may be left open. 
This doesn't become obvious until later, as an error message 'Open' 
may be displayed when an attempt is made to delete or overwrite the 
file' Alternatively, a Too many files open' message may appear. 

An operating system command exists to dose these incomplete files so 
they ran be deleted This is mCLOSE, it is available on BBC B+ micros and 
the Master series. It closes ail the open files on the current filing system 
However, pec r micros with Disc Filing System 0.9 nr L2 don't have 
this command. The ViewShtel and VtcwStQf?- A Dubhand Guide 
program disc (see Appendix Ej contains a *o,ose utility for BBC B micro 
owners. 
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Program Listings 

ID REM V5XFER transfer driver source 
20 H£« by Graham Hell 
30 REM for B/B+/M/C/E + VIEW family 
40 REM (C) Acorn User July 1906 
50 t 

6D hrkv - &202 
70 asflnd = tFFCE 
ao osbput = 6FFE4 
3D Q&ascl - 4FFE3 
iCO QSWOrd = 6 FFFL 

110 oahyte - *FFF4 
UQ : 

130 DIM code tFF 
140 FOR 1% = 0 TQ tFF 
150 I%?cnde * D 
160 HEX? 

170 i 

3B0 off = code - 6400 
130 : 

500 FOR pass « 0 TO 3 STEP 3 
210 Fl - code 


220 

[ 

OFT 

pass 


230 


-IMF 

output. 

- off 

240 


RTS 



250 

-hand 

OPT 

FNequb 

(03 

260 

-yreg 

DPT 

FHequh 

(03 

270 


JM? 

C1G3B ■ 

■ off 

200 


RTS 



230 

,nbrk 

OPT 

FHequW 

(break - off> 

300 


RTS 



3 in 

■ 

* 




32 D 

- 

OPT 

Ptt#gU 6 

i " ? einaneii f loopS"] 

330 


OPT 

FNe«rJ- 

(CHR& 13 * CHR51SJ 

34 0 

: 




350 

.block 

OP? 

FNequu 

(flQAItt « Off] 

363 


QFT 

FNtfqub 

i 64FF - IfInane- off]} 

370 


OPT 

FNOqub 

U3j 

300 


OPT 

FHequb 

f!26j 

390 

; 




400 

.openfl TXA 



410 


PHA 



420 


TYA 



430 


PHA 



440 


LDY 

u« 


450 

xinessag 

U 1 A 

tent - 

off, I 

450 


JSR 

osasci 


470 


DE¥ 



40D 


BFt 

me 55 eg 


490 

; 
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SOD 

LDA #0 



510 

LDX 1[block 

- off? HOC 

256 

520 

im f (block 

- of Cl DIV 

256 

530 

J5R osword 



540 

BCC noese 



5S0 t 




550 

TJM 13.24 



570 

D 5H osbyte 



5S0 

BRK 



S90 

OPT 

[129* 


£00 

OPT FHequs 

1 

s 

= 


610 

BRK 



620 ; 




6E0 .no&gc 

LDA *129 



640 

LpK tKlnaine - off) MOD 250 

650 

LOY Mflniuce - d-ff] DIV 256 

660 

J5ft osilfiii 



£70 

AUD l&FF 



£00 

f loperi 



690 : 




700 

BRK 



710 

OPT FNequb 

[1291 


720 

OPT PWequs 

[■'Can't open fill 

730 

BRK 



740 i 




750 . f lopert STA Hand - 

off 


760 

J5R vector 

-off 


770 

PLA 



700 

TAY 



79D 

FLA 



000 

TAX 



BIO 

RTH 



020 i 




Q30 .close 

UJY band - 

off 


£40 .ojall 

LDA #0 



ssc 

03find 



060 

5TA hand - 

Off 


870 t 




8B0 .vector 

SEl 



BOD 

LDA brfcv 



900 

LDX ribr* - 

off 


910 

STA nbrfc - 

off 


920 

ST* brkv 



930 

LDA bFlTV * 

l 


94 0 

LDX nbrk * 

1 - off 


950 

Sta nbrk * 

1 - off 


960 

3TX brkv * 

1 


970 

CLI 



9BD 

BTS 



990 ; 




1000 *break 

PHA 



1010 

TXA 



1020 

FHA 
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1030 

TTA 



1040 

PHA 



1050 

LDY 

10 


1060 

J5R 

cliM. ■ 

- off 

1070 

PLA 



1030 

TAY 



1090 

PLA 



1100 

TAX 



1110 

PLA 



U2 0 

,fMP 

tbvkv) 


1130 l 




1140 . output 

PHA 



1150 

LDA 

Hand - 

■off 

1160 

BNE 

ibopen 


1170 

JSR 

open f I 

- of* 

llSO .isapen 

£tA 



1190 

PHP 



1200 

&PL 

print 


1210 

AND 

1127 


1220 

BEQ 

htone 


1230 

LDA 

M01 


124 0 *Atone 

ORA 

12 6 


1250 ,print 

STY 

yreg - 

off 

1260 

LBY 

band - 

off 

1270 

JSR 

flabput 


1230 

LDY 

- 

off 

1290 

PLP 



1300 

BMI 

naprin 


1310 

JSR 

oeasci 


1320 P fipprlr, 

RTS 



1330 : 




1340 .flfLdJtue 





1350 : 

1360 1 
1370 NEXT 
1360 : 

1390 anml » 0 
1400 FOR II - 0 TO AFF 
1410 sum! = ItYCdda + sum I 
1420 NEXT 

1430 IE symi <> S49A2 TREfi FRUIT 41 Xa ae mb 1 e r 
please check Hating": EWD 
1440 t 

1450 PROCGSCli rSAVE VSXFER Hh + 5TR0- code 
40C 400*1 
1160 END 
1470 s 
14G0 : 

1430 s 

1500 DEF Fftaqnb (byte!) 

1510 ?pl = bytE% 

1520 PI - PI * 1 
1530 - pass 


Sfi 


error - 

+ " +100 
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1540 : 

15 5 & DEF FH«£JUW (vardtf 
1560 ?P% = *ortf% MOD 256 
1570 Pill - word! DIV 253 
1560 FI - P% ' 2 
1590 = pas* 

1&0& : 

1610 DEjr FNequS CString?J 
1620 $F% • string? 

1650 Ft = FI + tm string? 
16410 = pass 
1650 ; 

1660 DEF FPOCosclI Utring^J 
1610 DIM X% *FF 
1600 ft = XI DIV 256 
1690 &XI - string? 

1700 CALL *FFF7 
171D EHDPROC 


Listing 6.1 VSXFES transfer driver. 


10 REM ASCI? spaolEr source 
1190 EMI ncprln, 

1200 i 
1210 : 

1220 l 
1250 : 

1240 f 

1250 STY yreg - off 

1290 r 
1300 : 

1430 IF sural <> M&Fl THEN PRINT "Assembler error - 
please check Hating"; EWD 
3 450 PROCoecU ("SAVE ASCII 11 * 3TH$- code +■ “ *1011 
4DC 4O0 p t 


Listing 6,2. Alterations to program 6.1 for A5CTI spooler* 
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There are three fundamental types of database that can he used with a 
computer such as the HtoC micro. The first is a store of information where 
the data can be divided only once, so thai each section is considered as 
an Indivisible packet. An example of this type of database is a Viewdata 
system such as FresteL The data comes in pages, but you can't sub¬ 
divide those pages any further. 

A more advanced type of database has a two-fold structure. The 
primary division of trie database into records remains as above, but ail 
the records can have sub-sections. Corresponding sections in each 
record contain the same type of information, so the structure within 
each record is the same. An address book has this type of structure; each 
entry (section) has several lines {sub-sections), one for the name, a 
couple for the address and one for the telephone number. This type of 
database is often described as a flat file, because it is two^imcnsional- 
Vieu*Store manages this type of database. 

Hie words you most often hear to describe the sections and sub-sections 
are records and fields. A flat file database is split into records, each of 
which has the same number of fields In the address book, each name 
and address together form a single record. Each part of an entry forms 
a separate field, for example: name,, address line one, address line two 
and telephone number fields 

The most complex type of databases on a micro are three-dimensional, 
anti are described as relational. This type of database is characterised by 
having two or more fiat file structures linked by sharing particular fields 
within each record- Relational databases lie at the heart of most 
business software, for example accounting and stock control systems 
Here several sub-systems, such as purchasing and sales, each operate as 
separate flat files, recording the details of every transaction. But these 
fiat files must all share the same 'number in stock' field 

Figure 7.1 summarises the three different database structures. 
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Ona'dimensional 

$|rgciur$ 


Flal U\& databasa 


Relational ustfl&ase 
with fields linked 
between IMes 


Figure 7.1 Throe fundamental types of database 

The terms database and database manager tan be confused, so let's 
clear that up. The database is just the store of information and the 
database manager is the program that helps to keep the whole thing 
organised. But a good manager can make all the difference between a 
valuable information resource and an attic full of junk 

The First Database 

This section describes many of the basic features of the ViewStore 
database manager, and uses an example database on the VizwSh&t 
and VimStor* - A DeMtani Guide programs disc. 
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Starting ViewStore 

ViewStore is supplied on .1 rqm chip to be fitted into one of the sideways 
ROM sockets in the micro The instructions for doing this are included 
with the ROM, There is also a function key strip, and this should he 
attached to your keyboard above the reef keys. VlewSttijc is also 
available on a 3.5-inch a dps disc for the Master Compact micro, and as 
part of the OverView package far the Master 128. The OverView 
carl ridge should be pushed into one of the the cartridge slots on the 
ri^ht side of the micro, Econel site licences for sideways RAM versions of 
ViewStore are available too, so one copy of the software can be shared 
between all the users on a network. 

Disc, adf$: Some programs on the ViewStObt disc are an integral pari 
of the ViewS to re system. Either put the View-Store disc in 
lhe disc drive, or belter still copy the disc onto a spare 
blank disc and use that instead. Keep the original 
ViewStore disc in a safe place. 

Net: Consult the network manager about copying the utility 

files into the necessary directories. 

When the software is installed, ViewStore may start automatically 
w hen CTRL-BREAK is pressed. More likely, you will have to type: 

*STORE 

at the usual V or '=*>' prompt. 

On entering ViewStore, the Command mode screen is displayed, 
showing the amount of free memory and the screen mode in use, fur 
example: 

Wmmmm 
s*t« a rt* fws; 

Editing lb nil 


The tiytes free" figure shown is that tor a 6502 second processor; with an 
ordinary BBC micro there will be fewer bytes free. On a Master series 
computer the figure will be different. The cutsot flashes by the familiar 
'=>' prompt When you see this prompt, ViewStore commands such as 
MODE l can be typed. So too can filing or operating system commands 
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like *CAT or +KEY, You can also choose another language, using a 
command such as *basic or *shee t. Try typing in: 

*CAT 

The disc catalogue should show at least some (lies in a directory TJL 
These files are the ViewStore utilities that can be used to manipulate the 
database. 

Like vmw and ViewSheeb ViewStore has two different modes. 
Command made and Oirfri made. However, pressing ESCAPE won't 
immediately switch to the Data mode screen, because there isn't any 
data. An existing database has to be 'loaded' in before it can be 
examined. A database can't be created from scratch just by typing in 
data. To create even the tiniest database, a special SETUP utility program 
must be used. However, both the ViewStore utility disc and the 
Viewsheei and ViewStore A Diamond Guide programs disc contain a 
sample database, $u a quick tour is in order! 

Loading a Database 

To load a database in ViewStore. the load command is used. For 
example, to load the sample database on the ViewStore utility disc type: 

LOAD exits 

or to load the Dabhand Guide Example, use: 

LOAD CREDIT 

The CREDIT database will be used as an example, but exactly the same 
features can be seen with the CARS database. 

The Command mode screen changes to show the name of the database 
in use, and consequently the amount of free memory is reduced. In fact, 
ViewStore doesn't actually read any of the data in at all, but it does load 
some data about the data. This 'database within a database' describes 
the format of the real database, so that ViewStore knows what to 
expect when it does read the data. At this stage, the screen displays 
something like: 

bylm* fr-* 23*5* 

Edi-irv? b.CREDIT 
Format F, CREDIT 
3c»an mod# T 
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Ware, the File frCKEOlT Ls ilie database itself, and ECKEDIT is the data 
about the data, telling ViewSfure how D.CRHDrr is arranged. P,CREDIT is 
called the database file, and F CREDIT is its matching formal file. 

Data Mode Spreadsheet Display 

Now the database is loaded in, we have ta press ESCAPE to look at it 
and so switch to Data mode. The screen alters to show some of the 
data. Reading in the data may take a few moments, then the micro 
displays the message 'Reading' at the top left of the screen. Dots are 
printed to show progress as data is read in. When die data is read in, the 
screen looks something like figure 7,2, 

L Qpac* S XrvSax&ti by uriCTj 1 
Start* o£ Cxadlbori 




EjVjJ -lHHf 3 i ruj 
.Is fipemEk 

HI-fib t-jiipj plc. 
rriBttti- X£w BMtiirg 
S/iitwtic Pipework 
FwajAik* PtinT^m 
Derby Journal PubA. 
fuasiftnfi fofUiftClIltf 
F-y*l«™t Lit Pipework 
R**tlri 5 


..WJPRESE 1 
UPlt 4, 

24 Spring 
fll ?ai I way 

3tJT.Dr Hou 
61 Railway 
24 Spring 

1 LaLinar 
Print Hurt 
Ur.it 4 , 

2 4 Spring 
Cl Paiiuny 


.JIDDFE3E 2..«iOra^ J. 
Ifiebec, "jrt.n. 

JLalibQui.!:* E*xVl l t. 
LlLtlacvar Serfryj. 
uroutt Rjs+J 9*ts fj 
Littl-acrver Daroye. 
IHKUM4W Qmfbr*. 
Darby 

Hret Darby 

H L E-7+C . I.'A'TI. 

AUitoirrw P*iW*- 
LJtilobVkr Darby n. 


■.pairccoee 

OU 1KN 
lMTlT IBP 
ECi IAS 

pc s arc 

-El 2AH 
EXIT ]E$r 
2E2 3PZ 
HU 3H 
CA2 im 

nci? Sbf 

DE‘j 2AB 


Figure 7.2 Example CREDIT database, In Spreadsheet display. 

At the top of the screen is a small status area showing the name of the 
database and other information. Below this is the daia, arranged in 
columns and rows. Because this tabular arrangement is like a 
spreadsheet, it is called a Spreadsheet display. 

The rows and columns of this display reflect the record and field 
structure of the database. Each record is shown on a single row across 
the screen; each field is a column. So a single cr/F such as the one picked 
out in white on the screen is a single field within one record. Below it is 
the matching field from the next record, and so on. The field names are 
shown at the top of each column; in figure 7.2 they are COMPANY, 
ADDRESS 1. ADDRESS 2 and SO on. 

As with a spreadsheet there may be some data in each record that can t 
be seen. Hie screen can only display a limited number of fields across 
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one row, and excess fields are lost r off the right-hand edge of the 
screen. You can scroll right to these fi elds. 

To retom to Command mode, simply press the ESCAPE key. This writes 
ah the data hack to the database h!e on disc before returning to the 
familiar Command screen. 

Remember BREAK should not be pressed at any time in Data mode; 
always use ESCAPE to stop a process or return to the Command screen. 
Although BREAK usually just returns ViewStore to Command mode, 
sometimes it might corrupt the database file, and make it impossible to 
use in the future. Because this might happen by accident, a back-up copy 
of the database disc is vital- Ignoring the need for a back-up is courting 
disaster. 

Net Consult the network manager about how to make archive 

Copies of the relevant database directories or files. 


Card Display 


An alternative to the Spreadsheet style display is the Csrrf display, Just 
press CHANCE DISPLAY (function key !£) to swap to the Card display. 

The screen changes to something resembling figure 7.3. On this display, 
each record looks like a card in a traditionatcard index box, or like a 
fi 1 led -in form. Two complete cards are shown in the figure The field 
names are printed on each card, and the data for each field is printed 
beside the field name 


L Bfuc* 4 


InOaxttti Jjy *ntjpy 

rierisHK, criditos^ 


Hama of CrwdltGE: 

OSWXMY V+limm Efiginwfir^ 


ftPUFESS l QflJ-t I. m 

mum * 

ADtFFESS 1 CfliTta. 

VQET&&* CM IW 

GOffAXr Sy«[ HnvtC i,?: k 

KHHBS 9 1 H apFs^p 
HHJRE3E 2 JlflSifcotLEruF 
ftQD*ES3 1 r«!l<ya. 
tOS^CUlS DC 1 T JUT 


Pfraics mm 

W.T 5 IS , 4 . He <- d. ra^rf- 
ZTCTT.- ITEPf |r.| Typ* 111 JjliS Zu 'Clip 

Wt.I 


ruvoicf wag* 

CATE <— a eLd 

STCCiEE ITUH |3h 1/3' PolypEa^ lmTtm P 
tl.Q 


Figure 7.3 Example CREDIT database, in Card display. 
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The differences between the two displays are not entirely cosmetic. The 
Spreadsheet display shows a targe number of records, but only a few of 
the fields of each record are visible at any one time. In contrast, the 
Card display shows each record in full; all the fields an? visible. But the 
price paid is that only a few records can be seen at one time- There are 
only two shown in figure 7,3, although more may be shown on the 
screen as ViewStore tries to fit on as many as possible. 

To change back to the Spreadsheet display, just press CHANGE DtSPLAY 
{function key * 2 ) again. This key is always used to switch between the 
two types of display- 

Just Browsing 

Whichever display is used, one field of a single record is picked out in 
white on the screen. This while block is called the field cursor. 

The field cursor marks the currency active field and record, and like all 
cursors it can be moved around using the cursor keys: 


next field 

previous field 
next record 
previous record 


RIGHT 

LEFT 

DOWN 

UP 


Used with the SHIFT or CTRL keys, the cursor key* move Ihe field cursor 
as follows: 


SHIFT-RIGHT last field of current record 

SHI FT—UE FT first field o f current record 

SHIFT-DOWN next screenful of records 

SHIFT-UP previous screenful of records 

CTRL-DOWN end of database 

CTRL-UP first record of database 


When In the Spreadsheet display, the fields 'hidden' beyond the right- 
hand edge of the screen can be inspected: just press the RIGHT cursor key 
until the field cursor is in the last complete field on Ihe screen, then press 
RIGHT once more The screen scrolls to the right Eo bring the next field 
into view. Furl her presses of RIGHT bring other fields Onto the screen, 
until the field cursor reaches unused, blank fields- To return to the 
beginning of the current record, press SHIFT-LEFT. 
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Try applying the same principles to the Card display. Pressing RIGHT 
causes the field cursor to step through the fields of the current record, 
though the screen doesn't have tp scroll a tall because all the Fields are 
already visible Again, SHIFT-LEFT returns the white field cursor Eg the 
first field of the current record. 

Don't worry if the disc drive occasionally whim into action as the Held 
cursor is moved about. Databases can get very large, with the 
equivalent of several thousand cards worth of traditionally stored 
information. ViewSiore obviously can't keep all the information in the 
me micro's small memory at once, so it doesn't try It leaves most of the 
data on the disc, and just reads in the sections it needs at any one time, 
so occasionally you hear the whirring as the micro finds the data. 

With the cursor keys, and SHIFT, browse up and down the database, 
using both the Card and Spreadsheet displays. 

As you browse and gel to know the structure, notice how some of the 
information displayed in the status area at the top of the screen 
changes. In the centre is the name of the database. This might say 'New 
carsi Specification and price' or Fictional Creditors', depending which 
example database us in use. Below the database name Is a line that 
changes to give information about the field currently highlighted by the 
held cursor. This may be just the field name, which is also printed on 
each card on the Card display and at the head of each column of the 
Spreadsheet display. But it might be a prompt giving more explanation. 
For instance, the first field of each record of the CREDIT database is 
called 'Company 1 , but the prompt which appears in the status area for 
this field is "Name of creditor:'. 

If the field cursor is moved beyond the last record of the database, or 
before Lhe first record, the message "End' appears in the status area. 

Changing Data 

So far, we have looked at our example database as an archive, - 
Information that has been stored once-and-for-alL never to be 
changed. But real databases are not static; they are interactive and 
dynamic. So the data can be changed whenever necessary 

So how can a chunk of diaid be changed? Imagine that an accounting 
mistake is discovered, and that in reality the company owes Systematic 
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Pipework Ltd £57.39 for invoice number DF309, and not the £46 08 shown 
on the CREDIT database. Move the cursor to this field; it is the last field 
within the second record in the database. The screen should look like 
figure 7.4, 


1 Sp*e» 7 * TriLtaKAJ by mntry 
Cf'.iT.itjeT.-Jj-'ng Aihhm it: 


SP 
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Figure 7A Altering an invoice total. 


Under the first character of the field marked out in white is a flashing 
cursor; this is the character cursor, and it marks where alterations will 
occur if anything is typed at the keyboard 


To change £46-0$ to £3759, first ensure that the field cursor is on the 
correct field, and then simply type: 


57 . 5 * 


As this is typed, the new characters appear directly in the field. This new 
data replaces the original contents of the field as soon as it is ty ped, so 
all trace of the old and incorrect £46.08 is lost. So now the spreadsheet 
display shows this: 

INVOICE_CVljTL . .,. .JHSOtWX 

VF 3 B* 17 . ■!. B B hi. frfl- 

You don't have to press RETURN to 'enter' this new data. If you press 
RETURN, the field cursor just moves on to the beginning of the next field 
or next record. 

Exactly She same process can be used on the ViewSture ‘CARS' example 
database. Change the price of a Mini Mayfair from OBti3 to £4259, ny 
moving the cursor to the correct field (the FRO field of the second 
record), and typing; 

4259 

When the change has been made, it is not necessarily recorded on disc 
immediately But If the field cursor is moved to another part of the 


) 


.) 

) 

) 


96 








Beginning with VtewStare 


database (perhaps by pressing CTRL-DOWN to go to the end of the data), 
then ViewSton? writes the altered data bade to the database file on disc, 
before reading in the new section of the database. In any case, the 
database file is always fully updated when ESCAPE is pressed to return 
to Command mode. 

Changes can be made in exactly the same way on the Card display. 
Move the Reid cursor to the relevant field as before, and type in new 
information- 

Editing Data 

The changes made above completely replace the old information with 
the new, but changes are often merely modifications of the old data. In 
fact, the old data can be edited, rather than replaced. 

The stores item c&) Reid of the second record contains '1/2" Polypropyl¬ 
ene P. This can be edited to contain 'Polythene' instead of "Polypropyl¬ 
ene, by typing over the letters which have to be changed. By pressing 
CTRL-RIGHT or CTRL-LEFT, move the flashing character cursor along the 
line until it is under the first 'p\ then type: 

then o 

Notice how the new letters overwrite the old ones (similar to the way 
they do in VIEW). At this stage, the field should say: 

1/2 W PDiytbeffljleire P 

with the hashing character cursor under the T. The extra letters can be 
deleted using the delete CHARACTER function (press key 19). 

As each extra letter is deleted, it new one appears at the end of the field 
A ViewStore field can contain more data than is shown in the width 
allowed on the screen, and deleting a few letters at the beginning means 
more can he displayed at the end. A field like this can be $cmtkd, to bring 
the rest of the field contents into view by pressing CTRL-RIGHT until the 
end of the field is reached, or simply by one press of the END OF field key 
(function key 15). There is a matching BEGINNING OF FIELD function too 
(key W)i 
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Extra spaces can be inserted into the field with INSERT CHARACTER (key 
IS), ana the rest of the field right of the character cursor can be deleted if 
necessary with DELETE END OF FIELD (the 13 function key). 

At the top of the .screen in the status area. 

L Space 

is shown- This means that (here is room for 79 extra characters in that 
particular record, Editing the record will alter the space remaining, and 
adding lots of new data can result in no room being left in that record, [f 
this does happen, then the computer beeps and the status area says: 

L Space 0 

To add any more informs Eon, data will have to be deleted from other 
fields in the same record, freeing a bit of space. Perhaps iso me I hi ng can 
be abbreviated? 

Adding New Data 

Putting a new record into (he database is equivalent to writing out a 
new card in a traditional card index. But new electronic records can 
only be added at the back of ViewStore's pile of cards; they can r t be 
slotted in at the appropriate place. 

The following description uses the Spread sheet display so if the screen 
is in Card display mode, sw itch to the Spreadsheet display by pressing f2 
(CHANGE DISPLAY)-1 lowever, adding new data in Card mode is exactly 
the same as for spreadsheet mode. Similarly, if the CREDIT database 
from the ViewSJiffri jurd VizwStore ; A Dahhand Guide programs disc is 
unavailable, adding a new record to the ViewStore CAES example 
database uses the same principles. 

To add a new record, first move the field cursor to the last record at the 
bottom of the database by pressing Ctrl-down. The screen of the 
Dabhand Guide example database should look like figure 7.5; the 
ViewStore care example looks very similar, though the data is 
different. Now press the DOWN cursor key; the message "End" appears in 
the status area at the top of the screen. The same message is displayed if 
the field cursor is moved above the first record too. 
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At this paint the space remaining for the next record is very large, 

L Spacfl !5«S TrtdrtWd t?f *nEif 
?toT» of Credlt-df 





itucm-Ac* Mna,tinfl £1 RMiL^y UctlWYM P*|ct*yi... RES. 

Figure 7,5- Adding a new record to the database 

So how can new data be added. Imagine a new invoice must be added to 
the credit database On the blank line below the last record (or on the 
blank card after the last card in Card mode), type in the details of the 
new invoice. First, type in the name of the company. This goes in the 
first held. When the Held cursor is on the COMPANY field, the prompt 
"Name of Creditor 4 is shown in the status area, type in: 


Huddersfield Bfist FOUndtEJ 


There are three things to notice here. First, as the first letter is typed, 
there is a pause while the disc drive spins; VtewStore has tn make sun? 
there is room on the disc for the new record. Second, because the 
company name is longer than the width of the COMPANY field, the 
whole field scrolls as the name is typed in. Third, there is no need to 
press RETURN at the end of the name to enter the new data. 

When the company name has been entered, move on to the next field 
using either the RIGHT cursor key or RETURN. This is the first of three 
address fields. Add the following address to the fields: 


ADDRESS l Ideal laundry 

ADDRESS 2 Hither spoon Line 

ADDRESS 5 Huddersfield, tf Yacks 

POSTCODE HDSL 7HT 


Notice that some of the fields have extra prompts in the status area, 
which can explain what the contents of the field should be. 

When the address fields are added, move cm to the stokes rrEMtSrt field, 
and use exactly the same procedure to add the following; 


STORES rt£M£) Furtiaautti viW&f 


INVOICE 

DATE 

AMOUNT 


EJ8T1B 
5.€.87 
76.99 
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In the remaining fields.. The screen scrolls to bring these fields into view. 
As the Last piece of data is added, the screen should look like figure 7.6. 

I 9mm J93H In^»M?d «itry 

ncnpwje miitohs 

Qtlt*l4n4lA? 

fi££*KSS 7,.AUOTEftft 1,-lH5ffTOTE.!rrW£S SHM'S).iMWitE DATE.piHDOflT 

Httl« 0 ¥«r Darfcy s. I£^ ZAB Tip Vuhtri WQQPOT* .l.fi ,0* fl_15 

Withanpoo Hudcfiirdfla 90?; 7KT frEtWHUEll ¥*LWM T3GTL& S.f.M 

Figure 7,6, Completing the new record^ 

Finally, when the new record is complete, press RETURN logo back to 
the loginning of the next record As many new entries as necessary can 
be added. 

At the end of the session, press ESCAPE to return to the Command 
screen. This makes sure that all the new data Is saved onto the disc. 

Why Use a Computer? 

So far, we have used YiewStore just like a card index. The cards have 
been browsed through, and new cards added. But what advantages 
does the electronic database have over the paper-based methods of 
keeping such information? 

Traditional cards are kept in a single order. A list of names and 
addresses are kept in name order, but not in order of the age of the 
person, nor grouped according to the addresses. A reference library 
often keeps mere than one Index system, so that books can be found by 
author, by title or by subject. Each book ha* three cards; one is kept with 
all the other cards sorted by author name, the second with another set 
of cards in order of title, and so on. And yet the information on each 
card is the same, author, title, subject, and the actual location in the 
library (perhaps a shelf number or Dewey classification) 

But ViewStore does better, it can keep just one set of cards in several 
different orders! With the ckedjt database loaded, go to the 
Spreadsheet display as normal The records are shown in the order in 
which they were origin ally typed in ■ that is what 'Indexed by entry' 
means on the lop line of the screen. 

To sort, or index, the cards into order, press (the JIMDEX FIELD 
function}. This produces a 'Fields:' prompt In the status area, showing 
the various index fields that the data can be sorted on. Ficking the 
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company field would sort the records into alphabetical order of the 
company names, date would index the records Ln date order and so on. 
So to index the fields by company, press: 

fB 

Fields: COMPANY, INVOICE, DATE 

Cffttfftny 

It doesn't matter whether the field name is in capital letters or lower 
case. The message 'Reading' is shown briefly while the records are read 
in from the disc in the right order, and after a few seconds, the screen 
should look like figure 77. The newly added record relating to the 
Huddersfield Brass Foundry is automatically put in its correct place. 

The Vie wStnro cars example database can be sorted into order by the 
same method; pressing !G gives a list of the fields which can be used as 
index fields^ 
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Figure 77 The records sorted by Company* 


Of course, the order can be changed any number of times; press 16 again, 
and choose another field to base the index on This is a fundamental 
difference between a traditional system and the computerised database; 
it means □ single store of data can be used in many different ways. 

When *3 database is sorted into an order this way, any record can be 
found very quickly, without searching through the entire database. For 
example while it Ls indexed by Company, to move directly to the new 
Huddersfield Brass Founders record, simply press the Ux'att^ function 
(key 17), 
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Value?" ts displayed in the status area, so type in at least part of the 
record to be located: 

r? 

Value? 

Mndd*rs 

ViewStore redisplays the records, with the first one that matches the 
given value at the top of the screen. 

One important point is that locate only works on the current indexed 
Held: if the records are in dale order, then trying to locate i [udders' 
obviously won't work. Change the? indexed field using the f6 key. 

The example database can be arranged in order of company name, in 
date order, or by invoice number, but also in order of entry. To go back 
to the original order in which the retards were typed in, press RETURN 
at the J Fields:' prompt:, 

f6 

Fields; COMPANY, INVOICE, DATE 

It is best to re order a database this way before adding any new data. 

Getting Data Out 

Another good reason for using a computer database is that the informa¬ 
tion in it can be used easily for other computer based applications For 
example, if it you needed to write letters to all the firms in ihe credit 
database, then with traditional cards it would be necessary to road the 
cards and type each of the envelopes by hand —very time consuming! 

But with ViewStorc, there are a range of utilities to extract data from 
the database and use it in various ways. One of the easiest is one that 
prints labels for letters. Businesses often use sticky labels mounted on 
rolls of paper with sprocket holes so that they caii be put through a prin¬ 
ter. The labels can be printed automatically with the name and address 
of anyone on the database. This obviously saves a great deal of time. 

To see how this is done, load the credit database in the usual way. In 
Command mode, type the following: 

MODE £ 

UTILITY LABEL 
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This changes the screen mode to ensure there is enough memory Tree for 
the utility, and then loads the utility program. At this point, ViewStpre 
may prompt: 

Insert utility disc b hit a key 

] f so, put the VjewStnre utility disc in the drive and press SPACE, then, 
when prompted, return the database disc to the drive and press SPactl 

The following prompts mil appear 

Use select file (N,*?: H 

Answering J Y* would print labels for only a selection of the companies In 
the database, but this selection hasn't been mode yet, so the answer 
must be x N r . 

Screen or Printer (5 f PJ? 5 

Typing d F is possible, if there is a primer connected and ready to print. 
The answers below are for standard 15 by four-inch labels, but trial 
printing on ordinary paper would work too. 

Label height I lines)? § 

Lines butwovrii each label? 1 

The labels are 15inches f a total of nine lines of space on a normal 
printer. 


Width Of label? 35 

There Ls. room for up to 40 characters across a single four inch label. If 
the text on a label exceeds this maximum, then it mil be shortened. 


Characters beewsen each label? 6 

If there is more than one sticky label across the roll, then answer: 
s 

instead. The next question is: 

Nitmber of labels across the page? 1 

If there is more than one label across the width of the roil, then type the 
number of labels across. 
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ViewStore now asks for the information to be put on the labels, one line 
at a time. Answer with the names of the fields from which to draw the 
data: 


Line 

l? 

COMPANY 


Lin# 

27 

ADDRESS 

1 

Ltfifc 

3? 

ADDRESS 

2 

Lin£ 

4? 

ADDRESS 

3 

Line 

bi 

POSTCODE 


Line 

6? 

RETURN 



After all the lines of the label have been specified, pressing HETURN on its 
own makes ViewStoro move on. if the labels are being 'printed' to the 
screen, the labels are now displayed, but if the printer is in use, 
ViewStore now asks: 

Alignment print I 

Vie wStcire prints the first two labels, then pauses so they can be checked 
in case they have overrun the label, for example. If they are wrong, 
there is a chance to reprint the first two again If they are right, then 
ViewStore continues to print the rest of the labels. The first couple of 
labels should look like figure 7.8. The use of Ihis LABEL utility obviously 
lies in sending out batches of mail to people on a mailing list, the list 
being held in a VtewStore database, 

ItnliJLnr* £n guv** ring Ltd. 

Hint A, Rupiju- Ri± 

Hi *fcPKh 

Canton. 

C*2 ]MN 


Systematic Bipewrik Ltd. 
21 SptirHj l*im 
■fcnhbou riifl 

DE 1 T ur 


Figure 7-8 Two labels printed with the LABEL utility* 
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This LABEL procedure sums up maw of the features of a computer 
database. For a very small group q{ simple records, then neither 
ViewStore nor any other database manager is worth the extra effort. 
But with a large or rapidly changing store of information w hich may be 
frequently accessed in a variety of ways, the database wins hands down, 
The ability of the database manager to sort the data using several 
different indexes, to locate any particular record quickly, and to extract 
data using utilities like the label printer far outweighs the cost of setting 
up and administering the electronic database. 
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Building a new database is not a trivial task, just collecting the 
information can be a time-consuming process, and then it has to be 
typed into the micro or written out in a manually-kept database. At 
least with a familiar card index, it is relatively clear what information 
should be collected, and it really doesn't matter how this data is 
arranged on each card . If new"information comes along later, or if a 
vita] facet of the data was left off, it can always be added to the cards at 
a later stage. 

But with the ViewS tore database the decisions made about the 
information to be stored, and how it is to be kept, are more important. 
Things can be modified in the light of experience, but major changes to 
the structure of the data are best avoided. 

So time spent planning the structure of the database is time well spent 
As an example, we r ll consider the contraction of a database about 
articles in the microcomputer magazines, a sort of bibliography 

Working Backwards 

Perverse!v, the most helpful w ay to think about the database is 
backwards! First ask yourself the question: 'VVhat answers do I need 
from the database?' Think about how you want to use the information. 
This will lead to a list of types of information that have to be stored. 

Taking the example article bibliography, think how a magazine Index is 
used- The most common way is to look up an article whose title or 
author is known but the issue it appeared in has been forgotten. Rather 
than looking through a huge pile of magazines filtering the floor, look 
the article up in the bibliography to find the issue date or volume 
number. So this means that the author's name, the title of the article 
and the magazine issue date form the core of each record in the 
database. Furthermore, it means that the Title and Author fields must 
be indexed fields, so that the LOCATE function (key t7) can be used on 
thorn. It might also be useful to have the page number in the database. 
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But what happens if a list of all the articles on a particular subject is 
needed. One option would he to find out if that subject appears in the 
titles of any articles. Or perhaps pick an author closely associated with 
that subject But would either 'locate Control' or '[.ocate Telford' find 
all the articles about computer control applications? It is unlikely that 
they would all have the word ' Control' in their titles. Another way to 
do it is to use a series of keywords, perhaps with several words per 
article, describing the subject area of the article. So there is at least one 
other field to add to I he proposed article index database. 

We now have an author, the article title, the magazine name, a date 
and page reference, and a list of keywords for each article. Obviously, a 
single article relates to a single record in the database, but how should 
the information about each article relate to fields within each record? 

It is usually clear how the data Splits up, but some thought is needed. 
Should names be split into two fields, one for Erst name, one for second 
name? Alternatively, the name could be stored in a single field. But 
finding a name using LOCATE Is usually done by surname, as it is more 
useful to use 'locate- Telford' than "LOCATE Joe'. Is a list of people 
usually kept in alphabetical order of fust name? So the choice is to have 
a single field (for example, Telford, Joe') or two separate fields. The 
principle to use in. making this decision is to ask whether the two items 
of information would ever be wanted separately? 

It is unlikely that In a magazine bibliography the first name of an author 
would be required, but if a name and address were used to write 
standard letters, then both surname and first name might be required. 
Consider the difference between the 'Joe Telford' on the envelope 
address, and the 'Dear Joe' at the head of the letter. A separate field to 
contain Mri, Mrs', "Ms' or Dr r might also be helpful for mailing lists. 

It is a good idea Eo jot down everything possible about each of the types 
of data to store in the database. Think about how long the data will be 
In each field: dearly the article title is going to be longer than the name 
of the author., on average, perhaps 20 or 30 characters. Figure 8.1 
shows notes for the index of articles in the microcomputer press. 
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AUTHOR 

In 'surname, forename' form; up to 20 characters long; 
must be indexed sc* articles can be listed in alphabetical 
order of author 

TTO 

Article title; maybe 30 characters; must be indexed so 
articles can be listed in alphabetical order of title 

MAGAZINE 

Only needs one letter or a simple code (A=Acorn User, 
R=Byte etc) 

DATE 

Publication date; might range between 1/1/1970 and 
31/12 / 1999 (day of month is not used for monthly 
magazines) 

PACE 

A simple number between one and, sav r 300 should cover 
most possibilities 

KEYWORDS 

Most important word first, so alphabetical order of 
keywords groups articles properly; must be indexed so 
articles can be found by keyword 


Figure 8,1. Potential fields in ftrtid* database 

Files, Files, Everywhere.., 

Vien-Store uses a number of different types pf file lo manage its 
data bases. VVe have already came across database files, format files 
and utility programs. !(separates nil these types of file by putting each 
in a different directory on the disc, so the format files are put in 
directory F and utility program files in directory r \J\ 

VlewStore keeps all the data for a database in a single file, in a directory 
called 'O'. For example, the CREDIT database on the programs disc 
accompanying this book is stored in a file called 'D^CREUfK There are 
also other types of file, index files for example, stored in directory T, 
show ViewSton? which order the records should be in when indexed. 
There is one index file for each indexed field, so the 'credit 1 database 
has three files in directory T. 

In addition to these data files, ViewStore uses two other directories 
(S' and R ) to save other types of file. 


IDS 
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If is sensible to spread these files over whatever disc drives are 
available. The reason for this is that as new data is added to the 
database file, it grows. But if it grows loo far, it may come up against 
eilher the end of the disc or the start of another file on the disc. With a 
DPS, this results in the 'Can't extend' error message being shown on 
screen. The aim of spreading the files around is to give each one the 
maximum amount of space to grow. 

Files With DFS 

The recommended arrangements for files, different types of disc drive 
and the DFS filing system are as follows: 

Drive ff only Clearly, all the files have to be on one side of the floppy 
disc, although the ViewStore utilities in directory TJ r 
need not be copied onto the database disc if the database 
is expected to be large. When ViewStore can't find the 
utility program it needs, it prompts insert Utility disc & 
hit a key\ so the discs can be swapped. Remember you 
should use a back-up of the ViewStore utility disc, not 
the original. 

Drives 0 and 1 With two single-sided drives, it's best to save drive 1 to 
hold a copy of the utility disc, and keep all the database 
files on a single disc in the other drive (drive 0), 

Drives 0 and 2 A double sided drive is probably best used by arranging 
the database file Ln directory ‘O' on one side of the disc 
(drive 0) and keeping all the other Files on the other side 
(which is drive 2). If the database Is expected to grow 
very large, then it's better to keep the ViewStore utilities 
on a separate disc. 

Drives (3 to 3 Two double-sided drives are the most convenient 
arrangement for ViewStore, The database file in 
directory 'D 1 can bp kept on drive 0, while the files in 
directories ‘F and T can be kE?pt on the other side of the 
same disc, on drive 2. The other drive (drive 1) can be 
used to hold the utilities disc, the opposite side {drive 3) 
can be used to store temporary files that ViewStore 
creates in directory 'ST 
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Files with ADFS Or Net 

II you have an adfs or network the best way to arrange the files arc 

listed next: 

One drive only All ihe files have to be on a single disc, and with 
640 kiloby tes of space on a disc (assuming a large 
format), there is little point in not having the ViewStore 
utilities on there ton 

One floppy disc drive (called :0 or :43 can be used to store 
the data hies in directories "IT, 'F and T and R r , the 
other {;] or :5) can hold the OJ' utilities and the 
temporary files. 

Because a hard disc works taster than floppies, it's best 
to store all die files on the hard disc, in the same way 
you would wi th a floppy disc. 

Because the information in a database could be 
sensitive, it can be useful to have a separate user name 
on the network specifically for the database, so starting 
up the database may mean entering^ 

*X AM ACCOUNTS 03 

for example. Consult the network manager about 
setting up a new user name and possibly protecting with 
a password. 

Wherever they are stored, each of the directories T7, r F f T, S’. H' and IT 
will have to be created with *CDih before setting up the database, and 
the ViewStore utilities copied into directory TJ‘. If necessary, these 
directories can be sub-directories, so the name of the ^CREDIT database 
file on a hard disc could be '5,ACCOUNTS, VSIORE D.CREDtr while the 
matching format file could be 'SACCOur^rs vs rOPE F .CREDIT. Figure 8.2 
shows one possible director tree for a single floppy disc under ADFS. 


Two drives 

Hard disc 

Net 
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Figure 82. Possible adr directory tree. 

Setting Up the Prefixes 

When you iiave finished the basic planning, the database can be set up. 
Start up ViewStore in the usual way, or type: 

NEW 

to tell ViewStore that no database need be loaded. 

The first job is to specify where all the files are to be kept. This is done 
via a series of prefixes, which are added to the file-names to be used 
later. For format files, ViewStore assumes they are In directory 'F, but 
if the file is on drive 2 , then the prefix *:2? must he added- U isn't 
necessary to add any prefixes if all the files are being kept on a single 
drive, but they must be set if the files are spread across various drives. 

Typlng in the following: 

prefix 
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gives you a list of all the prefixes being used by ViewSlore. Initially: 


Df ata 
Floruit 
EIndex 
sjort 
Utility 

is displayed, showing no prefixes have been set 
To make J :2/ the prefix for the format files, type In: 

PREFIX F :2, 

Similarly, the prefix for index files can be set Hke this: 

PREFIX i : 2 . 

At each stage,, ViewStorc re displays the current prefixes: 

Cfiota 

Dermal. :2* 

E)nriex 

si curt 
Utility 

This shows that if ViewStore tries to load a database called 'credit', ft 
first tries to find the format file called ':2.F,CREDrr, 

The prefixes for the DF5 file arrangement with two double-sided drives 
suggested earlier should look Like this: 

D) ata 

F(pnnat : 2 , 
lirsdsx : 2. 

S)drt i3- 
UJtillty ti. 

ADFS, Net: If the database directories .ire further down the 

directory tree, then the prefix can include longer 
director)' names like "V STORE-'* In this case, ViewStore 
will search for a file called 'v^rORFi F.CREDIT' However, 
it is easier to move through the directory tree (with the 
'*DiK VStORE’ command) so that the F directory is a 
direct sub-di rectory shown in the current catalogue. 
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Any files contained in directory 'R' dulormtically use the same prefix as 
the T>' files. 

Setting up the prefixes has to be done every time ViewStore is used, but 
it can be done automatically by setting up a 1BOOT file as described in 
Chapter 16. 

Setting Up the Bibliography Database 

If there are already some files on the disc that will contain the database, 
first use 'compact, This makes sure the new database files are the last 
files on the disc, giving them as much space as possible to grow. 

When the disc or discs have been prepared, the database files can be 
created with the ViewStore utility SETUP. From Command mode, type 
in the following: 

UTILITY SETPP 

ViewStore finds the 'SETlT' progam using the prefixes already set. 

The initial prompt presented by the SETUP utility is: 

Set HE' database or report (D,R?7 U 

Here, answer TK* Ln fact, pressing RETURN has the same effect; when 
ViewStore presents two alternative answers in brackets like r> and R, 
then the first choice will be assumed if no answer is given. The 
construction of reports is covered in a later chapter. 

The next prompt to appear is: 

Filename of datdJaase BlULlQG 

The database file is to be called 'd bidlioc'. Notice that ViewStore 
automatically assumes the 'D-\ and that the prefix will also be added, 
so the file's complete could be 'fl.D.BlflUOC' Obviously, Ihe filename 
given must obey the rules for filenames on the current filing system. 
Next the filename for the format file has to be given: 


Format filename I database filename)? 
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I lere, just press RErflfftNa if the format file is to be called the Same as the 
database file itself (remember it is in a different directory). Otherwise, 
enter an acceptable name for the format file. 

Reserving Database Disc Space 

The next prompt is: 

Hsa many bytes to reserve? 


Usually, no bytes need be reserved for the database file. It starts out 
with zero size, but grows as data is added to it. So the answer should 
be zero: 


o 

DFS Users Note 

An initial size for the database file can be specified as additional 
insurance against the 'Can't extend' error message. If you can estimate 
die average number of characters per record and the approximate final 
number of records in the database guessed, then you can roughly work 
out the length of the database file. The size is: 

1.1 x chars per record x total records 

The bibliography might have perhaps 100 characters and 200 records, so 
the size is 1CW x 2D0 x LI, which Is 22,000. So enter; 

22 000 

at the prompt given on screen. 

Because of the way it works, the larger the Initial size, the slower 
ViewStore loads the database. But as the database fills up with 
information, it will be loaded quicker! This procedure is only 
worthwhile if using DF5 with drive 0 or drives 0 and 1 only. 
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Reserving Index Disc Space 

While space doesn't need to be reserved for the database itself, to 
ensure that ViewStore operates satisfactorily space must be reserved 
for the index flies. 

index files show which order the data should be displayed in when 
indexed on particular Helds. For example, if the computer magazine 
articles are to be m order of author's name, then the data must be 
indexed on the AUTHOR Held (with key fS), That causes ViewStore to 
check the order of the records in the relevant author field index Hie, 

In fact, ViewStore lias two different types of index files; updateable 
ones which it builds as data is typed in, and read-only ones which are 
created after the whole database is complete. There is a limit to the 
number of updateable index files a database can have. 

DFS f Net; There can only be four updateable index files, or three if 
you are going to use read-only indexes as well- 

AF>FS. There can be nine updateable indexes, or eight if read¬ 

only indexes are also to be used too. 

tn the bibliography example, there are three fields that are to be indexed 
fields, so three index files. But updating the index files as data is typed 
in slows ViewStore down, so only one will be used during data entry. 
The other two can be created later. The SETUP utility prompts for the 
number of indexes, and then for the expected number of records in the 
completed database: 

Hunker pf indexes? 1 
Number df records? 200 

The number of records is used to work out how much disc space to 
reserve for the index file. Always be generous and over-estimate the 
number of records to avoid problems as the database grows. 

Finally, SETUP asks for the filename tor each index file, and for the key- 
size. This Is the part of the database field that is to be used for sorting 
the records into order; the number of letters taken into account when 
arranging the records alphabetically. Too short a key length and 
'SMITH, Bruce' win not he differentiated from 'SMYTH E, Robin'. At least 
three characters are required in the key to split Smith and Smythe, and 
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eight to separate 'SMITH, Bruce' from 'SMITH, Sarah'. Remember the 
space counts as a character too. So ; 

Index 1; 

Filename? WJT 30 R 
Keysiae? S 

The key-size should always be the smallest that will differentiate all the 
records reliably. Too long a key just slows VfewSfcore down, If it is too 
short some of the records may be displayed out of order, though it does 
no other harm. Jot down the key-size chosen and the name of each 
index file; this information will be needed later. 

If the indexed field were a number, then the key-size should he the 
number of characters in the largest values expected. For example, if the 
largest money value in a Held were to be in the tens of thousands of 
pounds, then the key-size should be nine (23456,89, remembering to 
aUow for the decimal point and places, and a possible minus sign too). 

If the indexed field were a date, then the key^ifte should always be 
three, providing that dates are to be entered in the form 'ddmmyy' or 
mm.dd>y* 

When the key-size is specified for all the index files, ViewStore creates 
the files necessary for the database, using the appropriate prefixes set 
up beforehand. Figure 8.3 shows all the answers given to set up the 
niuiJtX; database using DfS and a double-sided disc drive, 

■^GTSLITir 5GTW 

SETUP 

Set up database or report: B 

filename of database? 

Format filename (database narse)- 3 
Haw many bytes to reserve? 0 
Number of indexes? 1 
Number of records? 200 
Index 1: 

FUensms? JUTOO* 

Keysise? fl 
Creating Format file 
Creating index l 
Creating Database file 
Database set up 
■> 


Figure 0.3 Creating the B1BLIOC' database. 
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Loading a New Database 

The new, empty datable created as described in Chapter Eight, can be? 
Loaded in fust me any other by typing: 

LOAD BTBLIQG 

Notice that although the database file is in directory J D r and the format 
hie is in directory T\ there is no directory named in the load command. 
This command also assumes that the prefixes are set up in the same way 
as when the database was set up. If the database has only just been 
created, then this will be true: if ViewStore has been switched off in the 
meantime, then the prefixes may need resetting. 

Press ESCAPE to switch to Data mode. The screen goes initially into the 
Spreadsheet display, as shown in figure Pd. The various fields are 
merely numbered- 

1. Bp+f- lAdftXAd by sntrv 



Figure 9.1. Initial Spreadsheet display of blank J Bibliog r database. 

The display shown in figure 9.1 isn't encouraging. It can be used as n 
database, but it's much better to customise the database to the specific 
needs o£ the bibliography. To do this, the database has to be Filled with a 
bit of data aboaf the data' This has to be put in two places: one called 
the database header and the other is the record format* 

The Record Format 

To take a look at the record formal, press IT The display changes to 
that in figure 9.2: it shows a blank record format- This is a mina- 
database, containing information relating to fields in the main 
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database, The record format holds each field name and other details. 
Each row across the record format defines a single field of the database 
(that is a column of the database in Spreadsheet mode). 

Fi*Isi rima 

FjijLi.1. riHjTii.. ., WLd^T.S.I'.ljai* limsc . .lUg.«i 1 mu t.2 Jtmff .Index nui 

Figure 9.2- Part of the record format. 

Field Name 

As discussed in Chapter Eight; the first Held in the bibliography database 
should be the Author field. So under Field name . type in 'AUTHOR*■ 
Entering this is just like typing information into the actual database. 

The second field should be 'TITLE', so enter this as the field name of the 
second field, in the second row. Names can be up to 15 characters long 
and you can insert spaces or numbers if you need to. 

Fn the final database, the fields In Spreadsheet mode are always 
displayed in the order used in die record format- So it's a good idea to 
keep tfie most important fields,, or those which will change the most, 
first on the list where they can be seen easily. 

The term 'wed' is the width of space allowed on screen (or the field. In 
Spreadsheet mode, a width of iive would bo a very narrow column of 
information, whereas a width of more than, say, 20 characters would be 
unnecessarily wide for the author's name. So enter '20' under w idth. 
Similarly r the? article fille field should be about 30 characters wide. 

If the width of a field is narrower than the field name, only part of the 
name will be shown on the Spreadsheet mode display. The width can be 
zero This means al] the data is hidden; it can be neither seen nor 
changed If the width is left blank, then ViewStore assumes a width of 
18 characters, 

Field Type 

The folio wing column of the record format, *T, requires the type of the 
field- As the T field is filled in. Type: A/TJMJD/M' is displayed in the 
status area to suggest the available types. These are now described. 
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A 


T 


N 


D 


M 


Afyiwnumtric. This allows bo Eh letters and numbers to be 
typed into the field, and is the most usual format If you 
don't fill anything in here, an alphanumeric field is 
assumed, the Author field of the Bibliography database 
should be of this type. 


Text. This also allows the field to contain any characters, 
but there is a subtle difference between alphanumeric and 
text fields. In alphanumeric fields, the information is 
considered as a whole; in text fields, each word or phrase 
can be considered separately. The Keyword and Title fields 
should be of this type so that articles can be found if you 
can remember only one or a few words of the title, or if you 
want to search through the list for all the articles relating 
to a certain keyword. 

Numeric, Only numbers are a I lowed in N fields. They can 
be positive, negative, decimals, or a combination, for 
example, '-466.129' Exponents such as 1 ,3 Ej 6 meaning 
1300*000 can't be used. The field width for a numeric field 
should always be at least large enough to show the longest 
expected number in full Remember to count minus signs, 
decimal points and places. So -466,129 would require a 
width of eight ViewStore won't accept letters in numeric 
fields and an error message of "Not numeric* is shown in 
the status area at the top left of the screen. 

Date. These must always be entered in the form 
'dd mm.yyl for example '12 07 87' meaning the 12th of 
July, 19S7 The full stops don't have to be used; both '12 7 
ftp and '12/7/67' are acceptable. VicwStore prevents 
entry of silly dates like 31st of April, 1987 or 29th of 
February, 1987, while accepting 29th of February, 1988. 

One limitation on dates is that because only two characters 
may be used for the year, all dates must be from this 
century. 

Dates can also be specified in American form: mm.dd.yy, so 
'12 .7,87' means 7th December 19S7. The British method of 
putting day first, then :he month, are reversed In ihc 
American notation. 
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The next column in the record format is S'. This indicates whether the 
field contents should he allowed to screff if there is more information 
than can be shown in the available width, say a 15-letter name in a field 
with a width of 10 Generally, text or alphanumeric fields should be 
allowed to scroll, numbers shouldn't. If 5 is left blank this is exact!y 
what happens A number longer than the field width can't be typed in, 
the computer just beeps. But there are times when an alphabetic field 
shouldn't scroll, perhaps to limit the text to a maximum number of 
characters. This might be the case with the Magazine field of the 
bibliography database. This could have a single character code for each 
magazine, and no scrolling and a width of one would limit entries to a 
single character. 

The 'D* column is only relevant to numeric types; it should be left blank 
for other held types. D controls the number of decimal places 
View'S tore won't allow more than this number of places to be typed in, 
and all numbers are displayed with this number of places. So If D is set 
to two, then 3.14159 can l be typed in; only 3.14 Is possible. And 217 is 
displayed as 217.00. If D is left blank or set to zero, then no decimal 
places are used in any numbers; this is what to use for the 'Page' field of 
the bibliography. 

Indexes 

The names of any Index files, and the length of their sort keys should be 
put in the record format, in the J Key r and 'Index name' columns. 

The file names used must match those used when the SETUP utility was 
run; if they don't then an index: filename not found' error message will 
occur. Tills can be sorted out by changing the name of the file Che 
•RENAME command, or by altering the name in the record format. It is 
more convenient to have the filename the same as the field name (as 
with the Author field), but it can be any valid filename according to the 
filing system used. Of course, all the index files are in directory L but the 
T should not be used in the filename. 

The key length should match that used for the SETUP utility too, but it 
doesn't have to; Setup only uses the key length to work out the initial 
size of the index files- It is the key length in the record format that really 
counts, so make sure this is long enough to differentiate the data 
properly. 
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In the bibliography database, three index files were planned, one for the 
author, another for the title and also the date, but only the AuthcT index 
was set up using the SEttll* utility The other two indexes fan be built 
Inter, but their filenames and key lengths can be entered now. But If they 
are, then the T field should be used to keep them switched off. This 
column can accept 'Y' for an active updateable index such as that for the 
Author field, ’R' fur a read-only index, or 'N' for an inactive index or no 
index at .ill- If left blank, then no Index is assumed- To switch off the 
non-existent Title and Date indexes, use N or a blank; use Y for the 
Author field. 

Limits and Validation 

The '1 jow limit' and the High Limit" are used to check each field entry as 
it is entered into the database. Obviously, values that are more than the 
lowest limit, and less than the high limit are acceptable, otherwise, 
Limit' is displayed in the status area of the screen and the entry is 
rejected. For example, to limit dates lor articles in the database to those 
in a single decade, the limits' I /I /SO' and "31 /12/$^' could be used, Make 
son? that the date follows the correct form, either dd.mm.yy, or 
tnm-dd,yy* depending on which date system selected. Be careful as it is 
possible' to type in a limit like 1 /1/19S0 by mistake, and then all dates 
entered will be disallowed with a 'Bad date' error message. 

This works quite simply lor numeric type fields and dates, but is more 
complex with the alphanumeric and text fields. With alphanumeric 
fields, entries are compared by alphabetical order, A low limit of 
DAAA J means that David Cunningham' could be accepted into the final 
database, but 'Cunningham, David' wouldn't be because it is earlier in 
alphabetical order than the Low limit. Similarly, a high limit of 'EZZZ' 
would, allow Truest Frobisher' but not 'Frobisher, Ernest' No 
distinction is made between capitals and Lower case, and if then? is more 
than one word, it is the first entered that counts 

Text fields are different again. They act tike alphanumeric fields as a 
rule, but if there is more than one word in the database entry, the limit 
check takes account of only the last word] This is not ns it should be: the 
ViewStore manual suggests each word is separately tested against the 
limits, but in fact only the first or last is relevant. 

Entries are not tested against any limits if the Low limit' or the 'High 
Limit' fields are left blank. 
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The limit test gives fairly crude contra! over the data that can be typed 
into the database. Where it is vital that data falls into a particular 
format, or follows a certain coding system, two further things can be 
done. 

First a. prompt can be given- The record format itself gives prompts: 
remember 'Type: A/T F N,D/M' This is useful lor two reasons. First, the 
prompt can give fuller details of the name or purpose of each field to be 
entered, particularly where the width set for the field is narrower than 
the field-name. Second, a list of permitted entries or codes can be given, 
or the format of the entry described For example, the author field of 
the bibliography could be prompted Author of article: eg SMITH, Bruce'. 
The Prompt column lies off the initial screen, to the right of Index 
name'; pressing RIGHT scrolls the screen towards the Prompt' field, 
where the prompt text can be entered. 

To limit entry to one of a few options, a complete list of the permitted 
entries can be put in the "Value lisf. If a coding system for the article 
references is worked out, ('AU' stands for Atom User magazine, 'B' is 
Byte and so on), then the value list could contain the following for 
example 'AU,B,FCWT 

The complete format definition for the bib!iopaphy database shown in 
figure 9.3 uses many of the features discussed When the format is 
complete, press the key for Command mode. This ensures that the 
format data entered is saved automatically in the Formal file F.RIBIJOG, 
which w r as created earlier by I he setup utility. 
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Figure 9-3- The completed format for the bibliography. 

The Database Header 


After the database format has been drimed, there is one final set of data 
to enter before I he blank database can actually be used. This is the 
tkltimw hi'ndt’j. It contains general information about the database as 
a whole, whereas the database format information all refers to specific 
fields. Pressing SHIFT-11 (DATABASE HEADER) gives access to the 
database header: the blank header is shown Ln figure 9.4. 


t 

Titll 


2*511 


titl# 
DiTfiUi- 
Bsccid ilio 
CflfKUy 
Inti** 11*1 g 
5cmn s*:J« 


Figure 9-4 A blank database header. 
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There are six pieces of information on the header, The Title' refers to 
the title of the database. If a title is specified, then it will appear centred 
in the status area gf the screen when the finished database Ls displayed, 
In both Spreadsheet and Card display, Of course?, a title isn't necessary + 
and it can be left blank. 

The 'Display 1 ' line allows a choice of 'S' for Spreadsheet and 'C for 
Card mode; whichever is chosen becomes the default display for the 
database. So If S is entered* then the Spreadsheet display will be used 
to show the database to begin with, but of course the Card display can 
still he used by pressing chance display (key 12), If 'Display' is left 
blank, then Spreadsheet mode is assumed, 

Similarly, 'Screen mode' and 'Index field’ control how the database is 
displayed when first loaded. For example, the screen mode might 
normally be set to '3', to show the maximum number of fields across the 
width of the screen And the order in which the records are shown is 
control led by the index field. So the bibliography database Could be 
displayed in alphabetical order of author's name as soon as it is loaded 
in. Mole that the name of the index field is needed and not the name of 
the index file for that field, though as in this case, they are often exactly 
the same. 

The "Capacity 1 line controls how many records ViewStore keeps in 
memory at once. How much spare memory there is depends on the 
screen mode, and the length of each record. The maximum is 50 
records, but this is usually too many unless a 5*?cond processor is used nr 
the records are very small A more usual number is 30. The maximum 
capacity is assumed if the database header is Eeft blank- If the error 
message 'Record too big' occurs while using the database, it doesn't 
usually mean that one particular record is too big, but that the capacity 
is too high for the screen mode, so either change the mode or the 
capacity, 

'Record size' is the most complex part of the database header. It 
controls the amount of space each record occupies on disc or in memory. 
There are two ways this can be used. 

The simplest is to enter a number, far example . This means that 
each new record can occupy up to 200 bytes. This gives space for a few 
less than 200 characters in the record. For the bibliography, that is 
probably enough: say 20 for I he author's name, a maximum of 50 for the 
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title, a few for the magazine code and date, and $o on, But this means 
that every record occupies 200 bytes of space, even if the actual data is 
only 50 bytes, imagine the waste of disc space if all the records were 
reauy short. Also, an especially tong piece of data would have fobs 
abbreviated; there is no quick way to extend the chosen length, 

The alternative is to allow each record to be a different length: not ah 
databases tan do this, but ViewStore can and it makes more efficient use 
of space in memory and on disc, lust enter a record size of, say, '+35'. 
This means that however long the record starts off when it is typed in, 
an i’xfrjfl 35 bytes of space will be left. This should give enough space to 
alter a record, if a name was spelt wrong or an address had to be 
changed. However, this method is not always suitable- Imagine a 
name and address book list: some names and addresses are added 
'whole' but some are added piecemeal; first the name and telephone 
number, then the address later. After adding a nanne^ ViewStore leaves 
an extra 35 bytes, and that might not hr enough for (hr address. All the 
other records can t just be moved up to make room. Using *+100' to give 
enough room for the address is possible, but that would add an extra 
10C1 bytes on to the end of all the records, even if the address were typed 
m straight away. That might be more wasteful than using a plain '200" 
front the outset. 

In general, the +35 method is best, but it depends on the circumstances 
If the Record size is left blank, then +20 is assumed. In contrast to the 
address book, the bibliography database has all the information 
available right from the moment of typing in each reference, so only 
enough space for editing need be left, so +20 should be adequate. 

The completed database header is shown in figure 9.5. Pressing PaTa 
(key (OJ returns ViewStore to the Spreadsheet display, and ESCAPE got-] 
back to Command mode. This also ensures the database header 
information Ls saved as part of the format file, F.BIBLlOC* 

Piprurd pis* 

PMplJty s 
ftotoxd pizfl *23 

3 rate* iiwl* XlTTHOn 
Sc £»*r, liocSb 3 

Figure 9.5. The completed bibliography database header. 
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Now the database is at the stage when it is ready to accept data. Some 
sample data is shown in figure 9-6; it's a selection of feature articles in 
the microcomputer press for early 1987. Try to either copy this 
information, or better still, get out a big pile of magazines and type in 
data relating to about 50 articles. 

Figure 9-6 is displayed in alphabetical order of author. Remember to 
index the database b\t cniri / before adding any data; 

fS 

Fields s AUTHOR 
RETURN 

Notice as the data is entered that there is a pause as the first section of 
each record is typed in, whilst the disc driver whirrs This occurs as 
ViewStore makes room for the new data and keeps the index of authors 
up to date. 
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Figure 9£. The bibliography database in use. 


Laying Out the Cards 

ViewS tore's Spreadsheet mode can look very unfriendly; there can be 
too much information displayed at once. Take for example figure 9.6. 
The screen is crowded with information, yet when the database is in 
use, probably only one of the rows at a time will be of interest It isn't 
quite so easy to browse through the database. 

Depending on the application, the Card display can be better. Compare 
figure 9.6 with figure 97, Although there are only two o! the references 
on the screen at once In Card mode, the display works in exactly the 
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same way as the Spreadsheet mode! DOWN switches to the next record.. 
RIGHT goes to the next field, SHIFT-LEFT returns to the first field of the 
current record, and so om 

t a U Indavod Sy 

Htgaunai AD^Itaora umi. B-FtyT». CwfUC*r World 


AnrtfDFi rcoeLWIMS, iUmrt »> Ea 

TITLE 1 If* it j L E*TI! TTiSUif 
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Figure 9.7 The bibliography in Card display mode 

The Card mode can he used while the data Is being entered, or while 
browsing through the database. In all respects, it is interchangeable 
with the Spreadsheet display. 

Card Display 

Press (2 [the CHANCE DISPLAY function key) to switch to the Card mode. 

If there is any data in the database, then the initial Card screen Ls hardly 
less daunting than the Spreadsheet mode. Rut this can be remedied 
Press CARD LAYOUT [key SKIFT-IG) to change to the srrwn designer, The 
screen designer can't be entered direct from Spreadsheet mode. 

The initial card design shown in figure 9.8 is not ideal Ail the fields are 
shown in the order they are in the record format, with the space 
reserved for each [that is the field width) shown as an underline. The 
underlines and fieldnames simply flow over from one row to the next, 
with no consistent formatting of the layout. 


ROrffiB 


FUST 


TITLE 


1*2 -ATE _ 


figure 9.8. The initial Card layout. 

This screen can be edited to improve the layout of the card. A tiny cursor 
flashes under the first field; it can be moved about with the cursor keys. 
As the cursor moves, it 'wraps around 1 from one edge of the screen to 
the other; take it off to the left and It reappears to Ihe right. It also 
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wraps around top to bottom, Position the flashing cursor over one* of 
the fields, either the name part or the underline part. Now pressing 
GOpy 'picks up' that field: this is marked by the first character of the field 
name changing to a '*'. Once picked up in this way, the field can be 
moved to some other place on the screen by moving the cursor to the 
place where the field should go, and then pressing COPY again. The first 
loiter of the fieldname is moved to where the cursor is. 

It doesn't matter if the field destination overlaps the original place; even 
very small adjustments can be made this way. But the destination 
mustn't overlap any of the other fields, otherwise the field is put 
somewhere else. In fact it's put in the first place further down the screen 
where it will fit. Note also that like the cursor, the fields 'wrap around' 
if there is too much underline to fit at the right of the screen, it runs off 
the right edge and reappears at the left of me screen a tow lower down. 

If you have trouble with this, then the best strategy is to move all the 
fields down to the hot tom of the screen, to get them out of the way. 

Then design the screen by picking out one field at a time from the bunch 
at the bottom, and placing each where it should go. 

Try to arrange the fields like this: 
jurnrcp 

tim:_ 

mi 

emit: __ 

P*3E 

fa vw M i “_ 


with the Author field on the first row of the designer screen. The lop of 
the area isn't marked, so check it Ls the first row by moving the flashing 
cursor to the Author row. then moving it up a single line; it should wrap 
around to the bottom of the screen if it is the first row. 

Now switch back to the Card display by pressing DATA (the to function 
key}. If the card layout is like that just mentioned, with six row s of data 
starting from the very lop of the designer screen, then three cards of 
information are showm on the card display screen, with a single line of 
space between them. 

If more space is required to make the break between cards more 
obvious, then this can be added. Return to the designer with SHIFT-tO. 
then move each of the fields down two lmes Move the last field first, or 
there will be trouble with overlapping! This places the Author field on 
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the third row of the designer screen. The cursor should take three 
upward moves before it switches to the bottom of the screen, Now go 
back to the Card display (press fO) which should show only two cards, 
The extra space introduced at the top of each card separates the two 
much more? dearly than the single blank row. 

The screen designer is probably the weakest section of VtewSton? in 
comparison to other databases. Many other packages let you 'paint 1r 
cards. Certain fields can be highlighted and text annotations ot boxes 
can often be added to the card. This can't be done in ViewStore. The 
only thing that can be changed is the layout of the fields across the card. 
Figure 9.9 shows the final design of the bibliography card, with four 
blank rows at the top of the card. 


HfffflOP 

TITLE 

mnera 


ravi 

CATC 


Figure 9.9, The final bibliography Card design. 

The only improvement that can be made in some cases is to add one or 
Iwd dummy fields to the Record format. These might have field names 

like J -—\ and a width of zero. With a zero width, no data can be 

added to these fields, and they don't appear on the Spreadsheet display 
at all. But the fieldnames do show up on the Card display, and using the 
screen designer they can be positioned adjacent to the most important 
fields, to 'underline" them; 


On the Card display itself, this appears as: 


jIUDTHOh 




The limitation with this is that the length of A fieldname can't exceed 15 
characters, so the 'underline' can only be that long. 
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Screen Modes and Colours 

Owing to the differences in screen width and depth between modes, 
each database format is meant for a particular mode. For example, a 
Card display designed for mode3 won't ftt on a mode 6 screen. This is 
why the mode specification is in the database header. 

Whatever mode is used (except mode 7), the screen colours can be set up 
by the method used within Viev.'Sheet, which is fully described in 
Chapter Five, For example, to select a dark blue background in 
YlewStore Command mode, hold down CTRL, and type: 

SO4OG0 

This colour will be maintained until another colour Ls set or the screen 
mode is changed. Pressing ESCAPE to look at the data doesn't change 
the colours. 

Sometimes a hidden' mode change can take place. For example, mode 
6 should be selected before running a utility program, to make sure there 
is enough spare memory. If the colours are set up in mode 6 and 
ESCAPE pressed to return to the Data display, the original screen mode 
is selected automatically, and as a consequence the colours are lost. 

If no screen mode is specified in the database header, then there can be 
other problems. No mode changes happen automatically when entering 
the Data display, so (he colours aren't lost- But if the Card layout 
doesn't fit the size of screen, then the whole thing reverts bade to it's 
original, unformatted look, as shown in figure 9.8. For this reason, 
always set the mode number in the database hesder. 

Creating New Indexes 

When starting up the Bibliography database, three index fields were 
discussed, but in order to speed up data entry, two of them were not 
used. When the majority of the information has been entered, the two 
new indexes can be created. 

The INDEX utility program is designed for this. But before running it, the 
name of the index and its keysize must be put into the Record formal, if 
I hey are not already there. Also, the new index must be marked as 
active by putting either J EC or V in the adjacent T column- 
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V marks the index as active and updatcahte. That means that once the 
index has been created, VicwStore will keep it up-to-date 
automatically. In all respects, the new index wilt be similar to the 
Author index which was originally built up as information was typed 
into the database 

R marks the Index as ttad-mty, That means that ViewStore doesn't try 
to keep the index up-to-date. If elements within the data are modified, 
for example a spelling, then the index is not changed. This means that 
the modified data will appear out of correct alphabetical order. 

Figure 910 shows the two new index filenames added to the Record 
format, along with I heir V and R index types. 
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Figure 9.10. Amending the Record format to create new indexes. 

To create the index tiles themselves, the utility INDEX should be run. 
Return to VlewSton* Command mode and type: 

UTILITY INDEX 

The utility first asks whether to use a Stkct file* This allows creation of 
an index of just some of the records in the database, but the selection 
hasn't been covered and in this case a complete index Is desired. 

Then the fieldname needing to be indexed Ls prompted for. This is not 
the name of the file, though they are often similar. The utility program 
then constructs the index file. The whole process looks like this: 

= »umm ™ex 

INDEX 

use select: file [N, 1n ? H 
Field rape? TITLE 
I. TITLE 

Building Index. — --- 

35 records: processed 
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Tht Date index can be built in the same way. As soon as they have been 
built, the new Title and Date indexes can he used to sort the records in 
the database. In Data mode they appear in the list of fields available on 
pressing INDEX FIELD: 

is 

Fields: AUTHOR, TITLE, DATE 

TITLE 

This sorts the records into alphabetical order of the article litle- 

Eemember that because the relevant index can't be updated, this Title 
order is correct only until one of the titles is modified {within the 
appropriate key length). This also applies if a record is deleted, or if 
new data is added to the end of the database. In this case, the read-only 
indexes should he rebuilt If new records added without rebuilding the 
Title Index, then they won't show on screen when the records are put in 
title order. Only the old records that the index file 'knows about' are 
shown. In contrast, the updateable Date index need never be rebuilt. 


10: Searching, Selecting, Sorting 
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The Bibliography Database 



There is a fundamental difference between a database and an archive. 
The latter is a collection of dead material that r s often difficult to sort 
through r whereas a database is a living store of information, easily 
accessible and always growing as new facts are gathered and added. 


Browsing through the database, sorting it into a particular order and 
selecting one of the indexes, then searching through the lists of 
information for items ot interest is not the best way of finding what you 
want. The computer is good at repetitive searching, so get it to do the 
work for you! 

ViewStore has a series of utility programs that allow easy access to 
database information in a variety of ways. One of these, the LABEL 
utility was described in Chapter Seven, 


Simple Selections 

The most fundamental utility program is SELECT This utility can choose 
a small set of the records and display them on screen or to be printed 
out. This utility is doubly useful because it can produce a sub-list of re¬ 
cords that can be used with another utili ty program. For example, a se¬ 
lection of name and address records can be used with the LABEL utility 
to produce labels for just some of the people on a database. 

It is important to remember that the records chosen by SELECT must 
have a common linking factor- be it simple or complex. Thinking of the 
Bibliography database, a simple link could be all the articles written 
about printers; a more complex one could be all the articles on printers 
or graphics that appeared in Acorn User magazine between March and 
May 1987, that were no! written by John Knight. 

So how does it work? First, load the database. As an example, load the 
Bibliography database from Chapter Nine (the? procedure is broadiy the 
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same for any type of database), Before starting SELECT or any utility, it's 
M? me times useful lo change to a screen mode which leaves adequate 
memory spare, say Mode h on a HBC model B, or into a shadow mode 
(for example Dlj on a model B+ or a Master series micro It's difficult 
to suggest just how much memory is required, as this will depend on the 
size and complexity of the records in the database. As a guide, the 
SELECT utility requires about 2500 bytes free fur Lhe actual program, plus 
extra bytes for the format tile and some of the data, Another good idea 
is to type in: 


LIST 


This shows on screen a list of the field names used in the database; the 
names can be useful to jog your memory. Figure 10.1 shows the result 
tor the Bibliography database, with the fields named and numbered. 


2 TITLE 
t DAT£ 

6 KEYWORDS 


3 AUTHOR 
3 HAG 
3 PAGE 


Figure 10,t. List of the Bibliography fieldnames. 


Still in ViewStore Command mode, type: 

UTILITY SELECT 

to run the utility program. 

If ViewStore responds by displaying the message Insert utility disc & hit 
a key on screen", then it means that for one reason or another 
ViewStore can t find the utility First r SELECT may be spelt wrongly: if 
so, then press ESCAPE and start again. Second, the disc containing the 
utility programs may not be in the drive, in which case simply insert it 
and hit the space bar. Tliird, it may mean that the prefixes nave been set 
up wrongly, or the utility desc is in a different drive to that suggested by 
the prefixes. If 90, press ESCAPE and set up the prefixes property. 

Once the SELECT utility is running, it displays the following on screen: 

List ar create select file [L,FJ? 

To create a subset of the database which can be used later with smother 
utility, press F. We will cover this in more detail later. To just list all the 
articles on printers, press L and RETURN. Simply pressing RETURN has 
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exactly the same effect, because L is the default choice here. Next 
select asks whether to print on the screen or on a printer: 

Screen dr Printer £5 r P>7 

As shown by the brackets, the screen is the default choke. Choosing the 
printer option without a printer connected will cause the machine to 
seize up; both the CAPS LOCK and SHIFT LOCK lights on the keyboard will 
tight up. If this happens just press ESCAPE and CTRL j C- 

Ncxt the utility asks for the $deci criteria. This is the common factor 
linking all the records you want to select together. To find ail the articles 
relating to printers from the Bibliography database, using the Title field 
would bo misleading, as not all the required articles would have the 
word 'printer' In their title- The Keyword field is more useful; the choice 
could consist of all records having the keyword printer': 


Select criteria? KEYWORDS = FRIIITER 

This means select all the records where the Keyword field contains the 
word printer. After RETURN has been pressed, ViewStore repeats the 
Select criteria" prompt; just press RETURN on its own to indicate that 
you have finished your selections. The utility then sifts through the 
database, and shows on screen the records which match the selection 
criteria. With the example bibliography database, thLs produces four 
records. Figure 10,2 shows the whole process, and lists the four 
matching records, 

FUTILITY SELECT 

SELECT 

List or create select file £L,f)? L 
sereen or Printer <S,P]7 s 
Select tr i Leri a? KEYWORDS = FRUITER 
Select criteria? 


KKtGUr, John Deirng It OR the Side 

YETTS, George Inspired Inscriptions 

W 3 LLIAKSQN,Clive Soft Options 
ftCHtFREEN,Robert Lotus rt&nnscxipt 


A Li 

1 * 4 .&7 

96 

AU 

1*5*67 

95 

AU 

1*6*87 

102 

PCW 

1.3.87 

132 


4 records selected out of 3$ 
m> 


Figure 10.2. Selecting articles on printers. 
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These records aren't listed in any particular order, even though 
according to (hr database header the database should be indexed by 
author as soon as it is loaded . In fact, the selections are always listed in 
the order they are stored in the main database file, In a similar way, if in 
Data mode and no specific index file ts used, then indexed fry eniiy' is 
shown in the Status area of the screen 

The records are shown much as they would appear in Spreadsheet 
mode, with as many fields as possible arranged across the screen. 

More Complex Selections 

Let's approach the more complicated selection mentioned earlier— all 
the articles on printers or graphics that appeared in Acorn User 
between March and May 1987 that weren't written by John Knight. 

Selection criteria can be combined, as is shown in figure 10.3. This figure 
illustrates a variety of points. First, = (equals) is not the only 
comparison that can used. The following can also be used: 

>= greater than or equal to > greater than 
<= Leas than or equal to < less than 

<> not equal to 

Applied to dates, < and >= dearly mean 'before' and on or after'. In 
text and alphanumeric fields, the data is compared alphabetically. 

->t mhlW SEU5 CT 
SELECT 

List or create select le (L,FJ? L 
Screen or printer (S,P*? S 
Select criteria? HATE >= 1.3.87 
Select Criteria7 AND 
Select criteria? date < 1,6.AT 
Select criteria? end 

Select criteria? keywoiUsb « printer 
Select criteria? 

KNIGHT, John Doing it on the Side AU 1.4.07 56 
YETTS, George Inspired Inscriptions AU 1.5,07 96 
SCttlFfiEEN, Robert Lotus Manuscript PCM 1.4,87 132 

3 records selected out of 39 
»> 


Figure 103 Using multiple selection criteria. 
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Second, individual selection criteria can be strung together with AND, 
so that ail must be me). The third record that was selected in figure 102 
has a Date field containing '1/6/&7- This matches the first test m figure 
10,3, but fails the next anti so fails overall OR can be used as well as 
AND, to link together criteria where the record should be selected if 
either option is Itue? 

it doesn't matter if you use capital letters or lower case ones—AND is 
the same as and, date is the same as DATE, and printer is the same as 
PRINTER and so on. So upper or lower case is ignored in fieldnames, in 
AND, in OR and in the data itself. 

As before, RETURN on its own ends the list of selection criteria. 

Exlending the Criteria 

Figure 10.4 shows al! the instructions to type in to select all the articles 
on printers or graphics that appeared in Atom User between March 
and May 19S7 w hich were not written by John Knight. 

When selections are this complicated, then it is probably worth writing 
them all down before using the SELECT utility. This is for two reasons 
The most obvious is so that you don't forget part of the selection. Less 
obvious Ls the fact that AND and OR don't have any precedence * SELECT 
just deals with them in the order they are typed in. this means that for 
certain choices, brackets are necessary to make the correct selection. 
Brackets should be used to make your choices crystal clear, even when 
they might be unnecessary - they can't do any harm. 

Think about the difference between; 

AGE >= 50 AKP ACE < GO OR AGE >= 30 ANO AGE <■ d Q 

and the following; 

(AGE >- SO AMD AGE 60) OR [AGE ^ 3-0 ANU AGE < 40) 

Pick a few ages and work through the first version, one part at a time. 
It'll to right. This expression can't select people in their 50s, because the 
final criterion is ant age < 40. The second version correctly brackets the 
criteria so that people either in their 30s Or their 50s are selected. 


137 


VicwBhcei and VlewSEonc : A DiibhancL Guide 


->VTILm SELECT 

SELECT 

List Or Creato select rile £L,FJ7 L 
Screen or Printer (5,PI? £ 

Select criteria? OATBi >- 1.3,0? 
select criteria? and date < l.S.S? 

Select criteria? AND (KEYWORDS = PRINTER 
Select criteria? OH KEYWORDS = GRAPHICS) 
select criteria? add hag - AW 

Select criteria? ANB AUTHOR <> “Eft if lit r JdArT 

Select criteria? 

JOHNSON-DAVIES,D Return el the Mardelbr AD 1.5,1? B1 
YETTSp George Inspired Inscriptions AU 1.5.0? 96 

2 records selected out of 39 


Figure 10,4. The final complex selection. 

Notice the placement of AMD and OR in figure 10.4 They are all at the 
beginning of a line. This is convenient and conventional but in fact 
there is no difference between: 

AGE >** 30 
AMD AGE < 40 

and the following: 

AGE >- 30 AND 
AGE < 40 

or even: 


AGE >« 30 
AND 

AGE < 40 

Note that you can't split an individual comparison as follows: 

AGE >* 

30 

it is worth noting the quotes around "Knight, John" in the final selection 
criterion. Quotes should always be used around fieldnames or data that 
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contain spaces, punctuation or other special characters. Only ordinary 
numbers, dales and single words can be left without quotes. 

You can use single or double quotes. Other characters can also be used, 
but they arc not recommended , Only if the data Itself contains both 
single and double quotes should the hash (#) or exclamation mark (1) be 
used, for example. 

Any one selection line can contain just a single condition, or a 
combination of several criteria The line can be up to 255 characters 
long As all the conditions are stored in the micro's memory, it is 
possible to run out of memory if the selection is too complicated - This 
shouldn't happen if the screen mode is changed to mode 6 or a shadow 
mode before you start the selection process. 

Alphanumeric and Text Fields 

By looking at the results of selections, the difference between an alpha¬ 
numeric and a text field can be seen Take a look at this record; 

Author. Titl*. .mm.m !«** Oat*.. F43* £ «>■** JT J H , , ... 

ran GUT. JsCtn Nig it OP! thm fcidtai WJ S.l.fll ^ a luhwya ninlflt 

The important point to notice is that 'Keywords - printed selects this 
record, because the Keywords Held is a text field, and so the pattern 
'printer" is compared with the data a imrd at a time* Conversely 
"Author = John" doesn't work, because the Author field is alphanumeric - 
the data is always treated as a whole. So text fields are selected if they 
contain the pattern word, whereas alphanumeric fields must be exactly 
the same as the pattern word. Even 'Author = Knight John' does not 
work, because there are two spaces, but only one in the data. 

In all other respects, alphanumeric and text fields are the same and 
because of their extra flexibility in selection, text Helds are better to use. 
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Printing Selection Results 

Before printing any results from VlewS tore, it may be an advantage to 
load a printer driver This isn't strictly necessary for simple results, but 
becomes so if any complex printer effects are required. 

ViewStore uses exactly the same printer drivers as VIRW and 
ViewSheet, so if the appropriate driver for the printer is available,, then 
it can be loaded with a command similar to: 

PR. INTER FhQlG 

tram ViewStore Command mode. This loads the correct FLOl* driver 
for the Ricoh Flo writer range of daisy-wheel printers, 

ADFS f Net: A fuller filename may be required if the printer driver is in 
another directory for example: 

PRINTER t . LIBRARY . FLOl £ 

The printer driver allows all characters to be printed as they appear on 
screen, including the pound, dollar and hash signs. 

Details of printer drivers for the View family are outlined in Chapter 
Six, It may also be necessary to select the network printer (with *FX 5 4) 
or a serial printer and the appropriate baud rate (with *EX 5 1 and *FX7 
and *FX ft). The details for this are given in Chapter Two 

Whether or not a printer driver is loaded, when the printer 15 set up„ a 
printed record of the result# of a selection can be obtained by answering 
V to the question: 

Screen or Printer tS*F1? 

The select utility then prompts: 

Printer width (£Qf? 

00 is the default printer width, so just press RETURN 1 if the printer is 
00 characters wide. A wider printer is capable of showing more fields 
across a row, so type in the character width that printer is capable of. A 
Common width for wide-carraige printers is 132 characters. 
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Other SELECT utility prompts follow the wme pattern as before, When 
Ihe criteria for selection are completed, then the records selected are 
printed out, just as they are shown on screen, 

Preparing a Select File 

Using ihe SELECT utility in this way is a simple introduction to its real 
function; ifs really meant fur creating stl&iian fiks+ A selection file Is a 
file on disc that contains a list of the records that match particular 
conditions. So far that's just like the selections above. But the list of 
records In a selection file can be sorted into order and then used by other 
utilities. So for example a list of people could be selected from a 
database, and Labels prepared for each of those selected. The list could 
be Sorted alphabetically by name, according to the age of I he addressee, 
or according to any other informalion in the database. 

The records can't be sorted unless a selection file has been created. 
Records can be listed in unsorted order only - that is in the order they 
were added to the database. 

To create a selection file, answer T p at the initial prompt: 

List qx create select file FJ 1 T 

Next the utility prompts for the selection conditions in exactly the same 
wav as before, A. blank line signals the end of the conditions, and the 
utility then asks according to which field the records should be sorted’ 

sort fleldl 

Type in the name of a field, for example 'Author' followed by RETURN 

Some lists are sorted according to more than one field. Think of the 
telephone directory There are thousands of Smiths, they can't be 
distinguished by their last names, so they are arranged by initials and 
first names. SoSmvthe, T5 proceeds Smy the, C, but both follow Smith, 7 
The surname Ls the primary sort field, the forename is a secondary sort 
field. The records are sorted according to the primary field first and 
where tw o can't be distinguished, their secondary fields are compared. 
If ihey arc still identical alter a secondary sort, a third field can tie 
compared too, and so on. 
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A ViewStore selection file can be ordered according to several 
secondary fields by typing in the fieldnames, one at a time, at the 'Sort 
field’ prompt* [f you don't need it sorted by a secondary sort field, just 
press RETURN, Similarly, pressing RET 1 RN alone terminates the list of 
secondary sort ftelds- 

The final pan of a selection and sort is to tell SELECT whether to sort the 
records into ascending or descending order. Ascending resulLs Ln 
conventional alphabetical order, or date order for date fields, or 
number order for numeric fields. Descending is the opposite, of course! 

The whole process of creating a selection file containing the 
Bibliography records, which refer to articles cm printers, is shown in 
figure 103 below. 

=■ >UTILITY SELECT 

SELECT 

List or create select file (L # FJ? r 
Select criteria? key* * PRINTER 
Sfilect criteria? 

Sort field? AUTHOR 
Sort field? DATE 
Sort field? 

Key width; U 

Ascend or Descend iA r D)? A 

Selecting. ..... 

4 records selected cut of 3$ 

SORT 

Sorting, ., 

=> 


Figure 1D3. Creating a sorted selection file. 

Wildcards and Field Numbers 

One other new element shown in figure 103 is the use nf a wildcat 
Vc/' is used as an abbreviation of the hill held name Key words'. To 
save typing the whole fieldname out, * can be used to match any number 
of letters, or 7 can match any single letter. Wildcards can also be used 
when specifying values in selection conditions. So: 


AUTHOR - SM» 
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could be used to select Smith, S my the and Small bone. The V matches 
any number erf letters after the *Sm'. Note that this includes no letters 
toti, so an author called ju$t Sm would also be selected. 

The fidd number can also be used in place of a full fieldname. This Ls the 
number listed by the fieldname when the LIST command bused. The 
Author field is field one, the Date field is number four, as is shown in 
figure 10.1. So the situation could be expressed as; 

i - SM" 

which gives exactly the same results. 

In the unlikely event that a fieldname is a number, then the field called 
*5? is used, rather than field number five. 

Specifying Longer Key Widths 

In figure 10.5 you can see the line: 

Key wiftn: n 

This means that ViewStore Is taking 11 characters into account when 
sorting the records into the correct order. How does it know to uso this 
number of characters to distinguish the records from one another? 

Basically, when a sort field such as the Author field is used, the SELECT 
utility always tries to u m the key width specified in the Key part of the 
record format for that field. For this reason, it can be useful to put in a 
key width even if no index is planned for that field. So the 11 characters 
of the key in figure ID.5 are made up of eight for the Author field and 
three for the Dale field, as specified in the record format. 

However, there are four exceptions to this rule First, if no key width is 
given in the record format, them the display width in the wid part of the 
record format is used. Second, if this is also blank, then the default 
display width of 18 characters is used. Third, date fields are always 
sorted with a key width of three, whatever their stated key width or 
display width is. 

The fourth exception is when a key width is specified explicitly along 
with the sort field. In the Bibliography database, I be Author field has a 
key width trf eight set in ihe record format. This controls the key w idth 
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used when creating the index file for [hat field. Naturally when a sort is 
called for, Lhe same key width is used. This can be overridden, and it key 
width oh say, IQ can ihen be used for Ihe sorting like this; 

Sort field? author, 10 

tf this were done, Ihen the combined key width for Author and Date 
fields would be 13 characters. 

This h only worth doing if the key width specified in the record header Is 
too short to completely diffe rentiate the records. Too Jong a key just 
slows the sorting process down The combined sort key length cannot 
exceed 250. 

Sorting Suggestions 

Sometimes no selection is actually needed, but the records must still be 
sorted into order. For example, you might want to prepare labels for all 
the people on a database, and it's convenient In have the labels printed 
in alphabetical order. 

In the utility directory r along with the files U-LABH1. and UrSELKCT, there 
is also U SORT- However, this eanL be used on Its own. TTiere is no 
utility SORT command This file can be used only by the SELECT utility. 

So to create a sorted file containing ail the records just press RETURN in 
response to the first selection prompt, as shown in figure 10.6. 

=> UTELTTY SELECT 

SELECT 

List or create select file <L,n? F 
select criteria? 

Sort fieldr HAKE. 11 
Sort field? 

Key width: 11 

Ascend dr Descend fA,D)? A 
Select i r a g. F 

51 records -selected out of 51 
SORT 

Sorting, ..... 

Figure 10.6, Creating a sorted file containing all records. 
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It is worth noting that the selected and sorted records from a database 
called BIBUOG go into a selection file called S.BIBUOC. There is a 
separate prefix used for these selection files, which can be set up with 
the following command: 

PREFIK S :2, 

If this prefix is set, then the SELECT utility creates a selection file called 
':2_S.BIBUOG *, 

The name of the select file created is fixed. If a second selection is made, 
then the new selection file overwrites the old one. All trace of the old file 
1$ lost With a very large database which doesn't change rapidly, it's 
convenient to keep ail the resulting selection files rather than 
overwriting them, because it can take a long time U> recreate them if the 
same selection is needed in the future. To do this, all you need to do is 
rename the selection file before yon create a new one. For example, like 
this: 

•RENAME :2 , S .BrSlTOC! t2,g,01BLIO4 

However, the fiewS BTOUQ4 file will have to be renamed back to 
S BIBOOG before il can be used again. 

If the database is very large, then the SELECT utility may create a 
temporary file called 5.5HTINT, plus whatever prefix is in use This fife is 
automatically deleted when it is no longer required, and it should never 
appear in a catalogue of the disc But it will destroy any other file called 
SSRTINT. 
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Selection Files and Utilities 

After creating a file containing the desired selection^ the list ran be used 
with all of the other ViewStore utiities, so I hat the utility is applied to 
only some of the records in the database 

Chapter Seven described the use of the LABEL utility to print address 
labels for the companies listed on a database called credit, which is 
supplied on the programs disc accompanying this book. A selection file 
canW created containing only some of the records from the database 
using (he SELECT utility* For example, a selection of the records for 
which; 


ADDR*2 = DERBY 
Oft ADDS *3 - OE-ftBY 

should produce a group of just six records pertaining to the fictional 
companies based in Derby, Note the use of wildcard characters within 
the fieldnames. 

This selection allows Libels to be printed for only those six records. 
When the selection file ts complete, the procedure For printing the labels 
is the same as that in Chapter Seven, except I ha I the prompt: 

use select file (W,¥)7 
should be answered with a *YL 

The first thousand copies of the ViewStore utilities d isc contained a bug 
in the label utility, 50 it couldn't be used with a selection file. The 'Use 
select file' prompt was never printed. An upgrade for this disc is avail¬ 
able front Acorn. 

Sorted Lists 

The major problem with the SELECT utility is that either the selected 
records are printed out, or they are sorted, but not both, A sorted list 
can't fee displayed. 

The way around this is to use the SELECT utility to select and sort the 
records, and another utility to display the information, REPORT is a 
complex utility, but the complicated bits can bo left until later. In its 
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amplest form, it can display or print the sorted Usi of records from a 
selection file. 

When the selection file has been created with sorted records, (as shown 
in figure 10*5), you cun run the REPORT utility- The utility normally asks 
only three questions. First, whether to use the select file, and second 
whether to use the printer or display the records on the screen. The third 
asks whether to use a report format filr* here the answer should 



The utility then displays as much of each record as it can fit across the 
screen or paper, this is shown in figure 10.7 Notice the similarity with 
figure 10 , 2 , although the fieldnames are printed at the head of the list of 
records, 

UTILITY REPORT 

REPORT 

Use select file IN, if)? ¥ 

Screen or Printer 5 

Use report format ill * U 

AUTHOR TITLE MAG DATE RAG 

EUIGHT, John Doing it on th* Side AU 1.4,£7 36 

SCHiFREEH,Robert Lotus Manuscript PCW 1.4*07 132 

WILLIAMSON,Clive soft Option# AU 1.6-07 102 

YETTS, George Inspired inscriptions AU 1.3-&7 96 

=> 

Figure 10.7. Displaying sorted records with REPORT. 

To print the list out on paper, additional questions are asked about the 
printer. The maximum number of characters printed across the paper 
can be specified, with a default of BO, The page length can also be con¬ 
trolled. 

If the printer uses continuous stationery, then the correct number of 
lines per page should be typed in. The default is 66 lines per page, which 
is suitable for most printers and normal listing paper Seventy is more 
normal for continuous A4-paper, that is 11 > 3 . inches at six lines per inch. 
Therefore to the: 

Single sheets CH r ¥}? 


prompt, answer 'N\ 
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When a jingle sheet of paper is positioned correctly in the printer, 
perhaps an inch of paper sticks up above the print head, reaching up to 
the adjustable rollers. If single sheets are being used, then reduce the 
true page length by about six or eight lines and enter perhaps 62 tor 
A 4-paper, This takes account of the unused paper above the print head. 
Then answer TT to the single sheets prompt. This makes REPORT pause 
at the beginning of every page, so a new sheet of paper can be inserted. 

The utility presents a prompt: 

Page.. 

When the paper is set up, press the space bar tea print the page, or press 
M' to miss out that page. On each page, RETORT prints the field titles 
and a number of records, one per line. There are four less records per 
page than there are lines per page. 

Sense and Sensibility 

As a database grows, the information in it becomes more and more 
valuable. The flexibility of an electronic database means that data is 
accessible in □ variety of ways and many applications impossible with 
traditional paper records may be possible. But the data ateo becomes 
more and more costly to replace. The time and effort involved in 
collecting and collating information for even a medium-sized database 
is immense. 

It makes very good sense to keep back-up copies of your database, 
preferably in different locations. For the vast majority of databases, 
where their contents don't vary rapidly, then a weekly or half-weekly 
back-up session should be sufficient - The best strategy is to keep, say, 
two sets of back-up discs, and copy the whole database on to the least 
recent set of discs at each session, using the tHACKUP command. So at 
any time (here will be the original database, one back-up less than a 
week old and another less than a fortnight old. At the next session, the 
database should be backed-up onto the discs that are a fortnight out of 
date. 

ft a disaster does happen, the most recent back-up discs can be used to 
restore the database to its original condition without too much extra 
work or worry. 
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Net: Consult the network manager about milking back-ups. of 

the database, and about the procedures for restoring a 
damaged database. 

it is very important to bear the Data Protection Act in mind. An 
information pack about the Act containing a booklet and application 
forms is available from Post Offices, and further information can be 
obtained from the Data Protection Registrar, Springfield House, Water 
Lane, Wilmslow, Cheshire, SK.9 SAX, 

If no personal information relating about people Is kept, then 
registration is unnecessary If information concerning living people is 
kept, then registration may be necessary A very simple mailing list or 
record of accounts is unlikely to require registration. But ft is still wise to 
read the booklet. 

If any personal information database is kepi, even on behalf of a dub or 
other group, then it is a sensible precaution to make sure that all the 
people on the database know their details are included. Each person 
should have the chance to inspect their own entry, and have it amended 
or removed. Clubs could perhaps make it a condition of membership 
that electronic records be kept. This is the most difficult area for the Act, 
but providing no sophisticated use is made of the information and 
providing it is kept private* then probably there is no need to register. 

Registered companies that keep data on employees, customers, 
suppliers or any other personal data excluding simple payroll records 
should register .Even a payroll that includes employees age or se*, for 
example, is not a simple payroll, so it's almost certain that companies 
using this type of information should register Schools should usually be 
registered through their LEAs. 
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The Name and Address Database 



The commonest form of database - the name and address list - is also 
one of the simplest m structure Everyone keeps an address book, dubs 
keep membership lists, companies keep mailing lists, schools keep pupil 
rolls And this name and address List is an ideal application for 
explaining and using ViewStore, 

Planning 

Before setting up the name and address database, it's best to decide 
what data needs to be kept, and in what way you want to store it and 
how to access It Clearly, the names of the people involved, and their 
addresses are the most important items, but for, say, a sports club* the 
types of sport they each play may be important Kao. 

Taking a dub membership list as an example,, some of I he typical fields 
for the database are Listed in figure 11.L 


rule 

FUat ri4ii# 

SufMU 
Stroot 1 
5trn«t 3 
Street 3 

County 
Ppitcwti 
Phone nufutier 

Hambarshtp fill 5 oe just luciiL fnembarv 

H unbar 

Paid ilurd paid? 

Dat^ nt}3± ‘liiit paid up untU, 

Regi^fi pare of country 

£atu«ita a a «E intareat. 

Nptfra FGoifl fOz sJrithPF itOtfa 

Figure 11,1, Fields for projected name and address database. 


nr, Kiti Ha. Ps and so on 

at iriiliftl wLth full Bt.lvp 
‘ I in only indexed £ittld? 
plenty of iinoa for *^ei thfl 
Jor-g-PUT: B-ddreasseg 






; 
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The first three fields are fairly standard, but although the list of names 
will usually be kept alphabetically, the Surname field is not listed first. 
Imagine what the spreadsheet display would look like: 

Mrs Bridget Cartwright 

tills is much easier on the eye than: 

Cartwright Bridget Mrs 

The point to note with first names is that members whose first name is 
not known must be given an initial like 'B/. This is important, because 
with a mailing list, an initial can be used on the envelope label, but 
would look very odd if it were used in the letter itself: r Dear Rridgef is 
fine, but' Dear R' can't be accepted. So it is vital that people with just 
an initial can be selected from me database and sent a subtly different 
letter, perhaps saying 'Dear Mrs Cartwright'. How it's simple enough 
to use the select utility to find those records where the the first name 
field is a single character. Use the wildcard that matches any single 
character, T., to select all those records where: 


First name 


But what about Dr E F Connolly? Some people insist on using two 
initials, and their records would not be selected. So it is best to record 
them ail as follows: 


Hr a B + Careeright 
Dr E+ F* Connolly 


Eected by pulling out all those records with a dot as 
. Remember the V wildcard can match anything. 


These can both be so 
the second character 
even zero characters, so this can be done with: 


First name = 7. + 


Another way of selecting the records' Mrs B Cartwright' and 'Dr E F 
Connolly' would be to user 


First naitie = 7 OF 
Firat name = "? 7" 
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Sometimes it is even necessary to have an extra field in a mailing list 
database, especially for selecting which people should receive a formal 
or informal greeting at the beginning or end of a letter. This might be of 
particular importance in many of the professions, where some rtienls 
are merely acquaintances, but some are also personal friends. 

The next group of fields is concerned with the member's address. The 
only important point is to not assume that all addresses are the same 
length Leave separate Helds for the town, the county and the postcode 
sts that selections can be made, Very short addresses will have the Street 
2 and Streets fields blank, but this doesn't matter. 

The final group of fields gives the member's details. The membership 
number, unique to each member, and whether this year's fees have been 
paid, are important in most clubs. Less obvious are lists of special 
interests; an art association may want to select a list of members who 
are interested in particular forms of art Sports dubs often have 
different categories of members; social membership, squash only, or full 
membership for example. 

The region field gives a chance for a list of members from particular 
parts of the country to be drawn up. This could be done by address, 
picking all those who live in a particular county, but a wider grouping 
might be advantageous. Perhaps categories like Scotland, the North 
East, the Midlands and so on. 

Setting Up 

The main part of the format for the database is shown in figure 11,2 
This closely mirrors the initial ideas shown in figure 11.1. 

It is always a good idea, when there is a limited number of choices for a 
Held, to list all the possible values in the Value list field. The lists of 
permissible values for the Title, Membership, Paid and Region Helds are 
shown after the prompts ton. This reduces the number of errors in the 
same way a$ limiting date nr numeric entries with the low and high 
limits. Putting the permissable values in the prompt serves as a 
reminder when data is being entered 
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L Space 28BD3 
Field name 



i»ld n 


Wid,T«S,&*t.ow limit . + tfiuta Limifc,I,Key. lode x narre 


First name 
Surname 
Members ip 

Number 

Paid 

Date next du# 

Street 1 

Street ?. 

Street 3 

town 

County 

Postcode 

Telephone 

Region 

Interests 

Notes 

KAME 

ADDRESS 


4 

10 

Id 

1 

4 

1 

0 

2D 

2D 

20 

15 

ID 

9 

12 

2 

25 

25 

G 

d 


d o 


1,1.70 


9 SB 9 

31.12*99 


10 NAME 


L Space 2 S 8&3 


Prorcpt 

mamar? 

First name: Bridget or B. 

Surnames 

Mambarsbip: asocial, TSennis, HI onorary S*7,JI 
Membership number : 

Fees paid: U, t N,¥ 

Paid up t&s 
Address line 1: 

Address line 2: 

Address line 3 : 

Towns 
County: 

Postcode: 

Telephone numbers 

Region: SC a WE, Ml, VIW, 5, 5E r Eft SC, PtE* WWj 3, S£*EA 

f nt &r e= p-t 3; 

Further notes: 

Dummy field 
Dummy field 

Figure 11.2. Format for name and address dafabasc. 
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The Ink 1 rests section is marked as T, a text field, so the select utility can 
search for individual words within the field If it were alphanumeric, 
then searching could only be done for each person's first listed interests. 

Finally, a coding system is used for a few of the fields. V and N are 
obvious, but the Region field and type of membership are also coded. 
This does two things; first it saves memory because 'WW' is shorter than 
'Wales and West', and second it standardises the data All possible codes 
are listed in the Value list section Note yon must haw commas between 
the values in this list; if there are extra spaces then the checking still 
works properly. The field width for the Region field is limited to two 
characters, because the region codes are only one or two characters 
long. 

However, one potential problem arises here. When the Value list Is: 

SC, UW, M f WW, S, SE d ELA 

it is still possible to type in SC,NE\ because SC and NE are adjacent in 
the Value list. But 'SC,NW r and 'NE,SC can't be entered, and nor can 
J SC NE r To prevent this happening, the Region field Is limited to two 
characters and scrolling is disabled, so there is nn room to type in such a 
code. For the same reason, the Membership field is limited to a single 
character, 

fn some circumstances, it is possible that this property might come in 
useful to denote people who belong on the border between two 
categories But the Value list can get too complex to allow all the 
possibilities. 

Entering the Data 

This is often easiest using the Card mode; the display is certainly 
famjjjar to anyone who has filled in a few' ordinary file cards. Arranging 
the fields on the card is just a matter of putting them together in sensible 
looking groups. Figure 11.3 shows one possible card layout. Depending 
on how often you'll want to browse through the database, it may be 
useful to increase the width of the Interests and Notes fields, so that 
more of the informatinn Can be seen on one card; there is plenty of room 
for this. 
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name 


ADDRESS 


Title 

Street l 

First name 

Street 2 

Burn time 

Street 3 
Town 
County 
postcode 

JfljiriDeFstUp 

Number 

Telephone 

Ph Id 

Date next due 

Region 


Interests 

Notes 


Figure 113. Card layout for membership list. 

The only important guideline for designing the card is that the fields 
should be grouped logically, all the address fields together, one below 
the other, for example Notice that there are two "headings' on the card 
layout, 'teAMF:' and " address'. These are dummy fields the last two fields 
in the record format, and they are assigned a width of £€f0, I laving no 
width, they don't appear at ail on the Spreadsheet display. But on the 
card display, the fieldnames do appear, and can be used to annotate the 
card. They can be picked up and placed just like any other field, No data 
can be put into these dummy fields as long as their width remains zero in 
the record format The held cursor can't even he moved to them. 

if the database is going to be big, just typing the data in is a big task, so 
make sure that the caid layout is not going to be a problem. The best 
way to do this is to set everything up, then type in some records, perhaps 
15 or so. An inconvenient card wifi soon show itself up, and the layout 
can be changed as a result. It's much harder to change the order of the 
fields in the record formal, but it usually can be done This is quite 
complex and will be described later. 

When a few trial cards have been filled in, it's time to try out some of the 
intended uses of the database. It is belter to try no w than to find out 
tater that an important facet of the information has been left out of the 
database. If all is well after the trial run;, then the rest of the data can be 
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collated and entered into ViewStcre^ But don't be afraid to start again if 
something lias been forgotten. 

When All (he Data's In 

All the Information has been entered, so what now? A database is a 
resource, not just a store, and getting data out in a convenient form is 
part of the justification for all the effort spent typing the data in, 

Mailshots and Macros 

At least once a year, a club maintaining a list of members has to send out 
reminders that the subscription or fee is due. This can be done by writing 
a standard letter using a word processor such as view, then sending the 
letter to all the people who haven't paid up. But view has the capability 
to personalise each of those letters, using the munv facility The letter 
may look something tike that in figure 11.4 By surrounding this letter 
with dm and em commands a$ shown, it becomes a macro definition. In 
this case, the macro is named *aa', the name appears after the dm 
command. The letter isn't complete: it has gaps or patter irs, marked by 
©0, @1 and so on. 
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Ah 

@0 n u 

84 

15 

n 

n* *s 

1 August 19S? 

Dear @0 iJf* 

Can we remind yoy that your Subscription to the North 
H umber s 5. de E*?al Ten file Federation is due ttnc* again. 
Owing Co the ever-increasing cost of court 
maintenance, the CbwmittM has reluctantly been forced 
to raise* the annual subscription rates to £20 for 
social members, and £135 for playing members. 

However, we have now made reciprocal arranaenier-ts with 
the South HimberaidB Federation, and they have made 
available to us their court and changing facilities at 
Garthorpe. 

fours sincerely 
Hon Shepherd 
Secretary 


Figure 11A VIEW standard letter as macro definition. 
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The macro facility means that wherever the patterns @0 or @1 appear in 
the letter, they caK bo replaced in the printed version by something else, 
supplied In die form of a macro pummder list at macro call This is a 
list like this 

Wi [if,E. J. .E^wuvilly.TF.a &.j iqr*ry..<5,Haxw 1 j Claw^. .bv+cl-ty. WUM* F* US*. 7FE 

The various patterns in the definition are numbered @0, @1, and so 
on, up to a possible @9. Dr" replaces because it is at the beginning of 
the list; it appears wherever @0 appears in the macro definition In 
figure 11.4 E. F/ is @1, so it appears where ^1 appears, and so on. 

The parameters are separated by commas. 

Notice that the ©5 parameter is blank and has just the two commas. 

This will create a blank line in the standard letter, with only an LJ 
command on it. Interestingly, view doesn't print this blank line; unless 
there is some thing after the LJ, it just ignores it. This is good, because it 
means that addresses like Dr ConnollyX which have only two lines 
before (he town name, don't print with a gap In them It is also worth 
looking at the @4 parameter: 

<5, Maxwell CiOB*> 

Although this has a comma in it, it's still all contained within one 
parameter held together by the angle brackets. 

The completed personalised letler is shown In figure 11,5, with all the 
patterns replaced by their respective parameters. 

Dr E. F* Connuliy 
The Surgery 
5 MLaxweLl Clo&e 
Beverley 

HorLh HUBb0tSi4e, HP 21 1FE 
1 August 1991 

Etaar Dr Connolly, 

Can we remind you that your subscription Co the North.„, 

Figure 11.5. mew standard letter with parameters replaced i. 

Macros are ideal for sending out lots of standardised letters like ibis, 
and there is a special ViewSture macro utility aimed at extracting macro 
parameter lists from databases. These lists can then be combined with a 
view macro definition such as figure 11.4, and printed out. One 
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parameter iLst can be produced from each record in the database, so n 
personalised letter can be produced for every club member 

The MACRO Utility 

To use the macro utility the database must be loaded as with other 
utilities. As usual if using a m: n micro, it's best to change to a less 
memory-hungry mode. And use the list command to get a list of the 
fieldnames. 

Then run the utility as follows; 

UTILITY HKCftO 

The utility prompts for Four pieces of information First, it asks whether 
to use a selection file. Clearly, if you want to send the standard letter to 
everyone In the database, then the answer is no But usually, the 
maiLshot is more selective, and the selection must he done beforehand. 
Press ESCAPE to stop the utility at this point if necessary. 

The second prompt is for She list of fields from which to take the 
parameter information. In the case of the club members database, these 
might be the Title, first name. Surname, Street 1, Street 2 fields, and so 
on. Just press PE TURN on its own to terminate the list. Remember that 
the fieldnames can be abbreviated with wildcards; Tt*, First', Sur*, 
Str*l, Str*2 wiU do. 

Each macro pattern must equate with one database field. CnnfuAingly, 
the macro patterns in vttw are called ©0, ©1 and so forth up to ©9, but 
the macro utility prompts for Field 1, Reid 2 and so on; 


Field 

1? 

Title 


Field 

27 

First 


Field 

37 

Surname 

Field 

4? 

Street 

1 

Field 

57 

Street 

2 

Field 

£2 

Street 

3 

Field 

17 

Town, 


Field 

6? 

County 


Field 

97 




Reid 1 becomes ©fl> Field 2 becomes @1, and Field 10 becomes @9. In 
facl macro will continue to prompt for field names until only RETURN is 
pressed, but remember fields beyond Field 10 can't be used by view* 
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The? macro utility then asks for the name of the macro * this is the 
two- letter mme that appears after dm in the virw macro definition, in 
figure 11 A, this was 'aa': 

Twg letter macro? AA 

Finally, the utility needs the name of a file into which to put the macro 
calls. No prefix is applied to this name, so If it should be in a particular 
directory or on a particular drive, then name the file explicitly: 

Output file name? :3,V,SUeSHAC 

adr;, Net: A much longer directory name can be used if necessary, for 
example, '^ viiw ctUB^UBMACRO'. This creates the file 
stiBMAcm two levels down the directory tree from the 
root The root is the main directory selected with *om. 

Don't worry about fields with commas; the utility sorts them all out 
automatically, put tine angle brackets in wherever necessary, The 
output file can be loaded into veew, and it may look like figure 116, In 
creating the macro file, ViewStore reports how many records it looks 
through, four in figure 116, 

Aft Er.5. F - r Ctiiwally r Tb* Suiqnry,*5, Mumll r Bi-a*. HU2 E 7FE 

Aft Flat-, ] 7ft To-cft hud. .PackLLngrtan,)l, frwkv.Yfll? 5FT 

Aft yr.JSraMt.D^rtrv.Jl Tu*i*r 4 M Villftft, . ,FM*V r N. rodti.ru +LH L&lA 

3*4.men H*ii r Muia Dn.LV. P Cot t uv^h**.nr, HdlJiafeiriLd#. 

Figure 11,6, A view macro file 

Notice that a field that is blank in the database causes a blank parameter 
consisting of eight spaces: this won't usually be a problem. But if it is, 
then the blanks can be deleted by loading the file into view v?m on 3, and 
using the command ; 

CHANGE , *s„ ,, 

Sending Out a Subs Mailshot 

There are several stages involved in sending out the actual mailshot, a 
process often referred to as rtmilmerging. The first process is to think 
about to whom the letters should go Broadly, these are the people who 
have not paid their subscriptions yet, But a wise dub secretary sends an 
encouraging letter to those whose subs will be due within a month, and 
a different letter to those whose subs are now overdue Why? Because 
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the people with overdue subscriptions all got the encouraging letter the 
previous month [ 

When the recipients tan be identified, go ahead and write the letter using 
view. It might be easiest if the letter is written In one particular member, 
with all the personal data in plate. Then at the end, take out ail the 
personal information and replace it with the macro patterns: @€, @1 
and so on. Pot in the dm and EM commands, and give the macro a name, 
say a*. At this stage, note down the name, and what each of the macro 
patterns is: @0 is the Mr or Mrs, @1 is the first mime, and so on. 

The next stage is selection. If the macro Ls written so that the salutation 
is 'Dear Dr Connolly' or Pear Ms Cartwright 11 , then it can go to 
anyone; but if it is designed around 'Dear Bridget', then a separate 
selection for aU those people whose first name Ls unrecorded must be 
carried out, to eliminate the Dear E. F. r problem we have already come 
across in this chapter. 

Switch to ViewStore and load the database, then run the select utility. 
The selection criteria might look something Like this: 

Date next due < L.0.B7 
AND Date next due >= 1.7*67 
AND First name <> 7 + * 

AND Members trip <> H 

This puts all those whose subs are due during July, whose full first name 
is known, and whose dub membership is not honorary, intu the selection 
hie. This file controls which of the database records is used to create a 
macro parameter list, and ultimately who gets a letter, tfs convenient 
to sort the records into alphabetical order at the same time. 

Next run the MACRO utility, using the selection file. List each of the 
required fields, by referring to the notes, and remember that Field 1 Ls 
really 30. ViewSton? will create a macro parameter file. 

Still in VicwS tore, load a printer driver if necessary, and use the [Abel 
utility to print labels for all the letters to be sent out. just use the same 
selection file; it doesn't have to be re-elected, 

Finally, return to view. Load in the macro definition file containing the 
standard letter. At this stage, it is worth checking a few things Dues 
the definition have a page eject command, Ffi, at the bottom to ensure 
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that each successive letter starts on a fresh sheet of paper? Are the 
margins set correctly? Are there any unneccessajy blank lines? 

When everything looks just right, read in the macro parameter file using 
the read command. By using REAP, the parameter lists created by 
ViewStore get added to the end of the definition text It is besl to 
preview a few of the letters, by using the screen command, I o check that 
the correct data is being substituted for the macro patterns @1 and 
so on. Then load the correct printer driver, with the printer command, 
and print out (he letters 

As the selection file was in alphabetical order, the letters will he printed 
in the same order as the labels,, so it should be straigh I forward to marry 
the two together. 

Line Length Problems 

There is a single problem with the process outlined above. Details for 
each letter can be taken from lhe database and inserted where ©0 and 
#1 appear in the macro definition. But an entire macro parameter list 
must fit on one line, and view lines can't be longer than 132 characters, 
What if the name, address and so oft* add up to more than 132 letters? A 
message similar to: 

3 fields spilt 

indicates the macro utility has created three macros with parameter lists 
of more than 132 characters. The macro utility splits each over-long line 
into two. 

The VieivStore manual suggests that a split list should be abbreviated in 
view so as to fit on a single line. Fine, if only one or two macros 
overflow the limit, but what if 100 or 200 do? 1/ you keep a database 
containing addresses of legal or financial partnerships, or a database of 
advertising agencies with their long intricate names, it will happen all 
the time! Chapter lb presents an answer to this. 

Fite Maintenance 

So what happens when the subscription money rolls in? The database 
has to be updated to show people have paid, and wh?n they are next due 
to pay. 
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The simplest way to do this is to toad the database and go to the Card 
mode display, and then use the Surname index to sort out the records 
into order: 

is 

rie-lUs: Surname 

Sum am* 

Then any record can be found quickly using the locate function (key 17k 
r/ 

value? 

Cart* 

will find the fust person with a name starting 'Cart'. The new details 
tan be entered onto the card, and the next person searched for. 

At the end of the session, pressing ESCAPE to return to Command mode 
ensures all the data is saved and up-to-date* 

Deleting Records 

Inevitably with a dub membership, new people join all the time, and 
members also leave. On the database, new records are added to the end 
of the data file, and the file lengthens. Old records are deleted from the 
middle of the database, but View-Store can't, 'close up' the gap left; the 
data file never gets shorter because the space taken up by a deleted 
record is not reused. So even if the number of records in a database 
stays about constant, the file will grow and grow. And ViewStore will 
consequently work more slowly and require mom disc space than 
necessary for the files. 

Periodically* it is an advantage to reclaim the disc space used up by these 
deleted records- There am two ways of doing this The first relies on 
View-Store's convert utility. This always works by creating a new- 
database, with information taken from the original But this 
information can be modified in various ways. 

First, the amount of spare space in each record can be increased or 
decreased. This spare space is the 'Space' figure in the top left comer of 
the data screen. If the information in a record is changed, then that 
record may run out of mom New space can be created with the CONVERT 
Utility- 
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Second, a new sub-database can be created containing only some of the 
records from the main database. A selection file is used to select which 
records should be incorporated into a new database, 

Third r the fields within the records can be stored in a different order. 

For ex,implex the membership database could be re-ordered so that the 
first three fields were Surname, First name and Title instead of Title, 
First name and Surname, However, this also entails creating a new 
format file for the new database; the old format is not good enough 
because the fields are in the wrong order. 

Fourth, the space used by deleted records can be reclaimed; they are not 
copied over into the new database. 

Running the convert utility, the prompts are: 

Use select file (N,YJ7 

Enter TT unless you want to create a sub-database, in which case only 
the records in the selection file are carried over into the new database. 
These records must be selected beforehand. 

The next group of prompts begins with: 

Field 1? * 

Field 2? 

To copy all the fields in the original order and merely reclaim the deleted 
record "space or regulate the spare space in each record, fust type the V 
wildcard as shown. This is the most usual response. Otherwise, enter 
the names of the fields to be carried over, in the order they should 
appear in the new database. Fuid the list with RETURN on its own. If the 
fields are to be rearranged, it is a good idea to plan this out in advance. 
Before using convert,, print the names of I he fields in the database. 

Make sure fine printer is connected and type: 

list CTRL-0 
CTRL-C 

Use the list to plan the new order of fields. 

Next, CONVERT asks for the new record size. This is specified in exactly 
the way it is in the database header, explained in Chapter Nine A figure 
of '+20' means that 20 extra bytes of space will be left, whatever the 
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length of the information. That leaves room for about 20 extra 
characters of information, should the record need editing again, A 
figure like J 2D0' meins that a minimum of 200 bytes is used for every 
record, no matter how short it is. A 100 character record would have 
about 100 bytes of free space; a record with 300 characters of 
information would not be truncated,, but no free space would be Left. 

Finally, the name of the database has to be entered: make sure it is 
different from the old name! The appropriate prefix is used to name the 
file, sO‘ 

Kcw file name? MAKES 

could create a hie called M.D-Names', If the prefix shouldn't be used, 
then enter a fuller filename, such as ';G.$.Names’. Creating a new 
database in this way may take some time. When it is finished convert 
shows how many records there are in the new database. 

Once a database is converted in this way, if the order of the fields has 
changed, then a ne w format file will need to be created by edi ting the old 
one. The new database, 'Names', can be loaded, using the old 
database's format file, 'Members', with the command: 


( 

( 

< 

( 

( 


LQAO HAKES F. KEHBEH.S 

Furthermore, the old indexes will be out of date. New index files must 
be created with Ihe the Index utility described in Chapter Nine. 

Purging Big Databases 

A difficulty arises with converting large databases; there may not be 
room on the disc for both the old and the new database files. The PURGE 
program at the end of this chapter can reclaim the deleted record space 
without the need for two copies of the database. Note that this is a basic 
program, not a ViewStore utility. 

To use runes, Lype in the masjc listing, and save it. Run the program, and 
it prompts for the ViewStone prefix that was used when the database 
was set up, If there was no prefix, then just press RETURN. Next, type in 
the name of the database file to be purged. 1f just a simple file name is 
entered, then the prefix is added to this in the same way as VicwStore. 

If a specific disc ur directory is named r then the prefix is not added; so, if 
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the prefix is J HS t then 'Members' become J ;1,D.Members", and 
'^Members remains r j0,$,Members'. 

The program works through the tile slowly, compacting it and removing 
the deleted records. When finished, the number of records removed is 
displayed on screen. 

The r luge program incorporates a measure of security; it checks to see if 
the file named is a ViewStore database before trying to compact it. This 
can't be fully foolproof but it checks the file in the way used by 
VicwStore itsd/. Also, ESCAPE is disabled while the database file is 
being altered. However, if BREAK is pressed while e'ukce is working, 
then the database will be corrupted. Fur this reason, you should always 
keep back-ups of the database files. 

Keeping a back-up is also vital because the listing contains some 
assembly language, which may be difficult to debug. However, there is a 
simple check routine. 

The PURGE Program 

For the technically minded, PURGE checks that the file is a ViewStare 
database file by reading the last part of the file backwards. The structure 
of ViewStona files means that the last useful byte must he a chri % the 
end of data marker. After this there may be some padding bytes, oirs Q f 
but nothing else. So reading backwards, if anything except padding 
bytes is read before the end of data marker, then the file is not a 
ViewStore database. 

Once checked, the assembly language section reads chunks of the file 
into a 256-byte input buffer using the osesro cat]. Then providing it isn't 
part of a deleted record, each byte is transferred to an output buffer. 
When the input buffer is empty, I he next 256 bytes are read in from the 
file. When the output buffer is full, then it is written back to the file. If a 
record has been deleted, then the output takes up less room than the 
input did. The input and output pointers progress through the file 
together, with the output pointer trailing further behind as deleted 
records are encountered. 

If using an early m‘ micro fitted with Basic l, then alter tine 2320 to read 
as follows: 


2320 IF control! = "IT TESEN handle* - 0PENIN 
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( 

< 

f 

( 

( 

( 

< 

( 

c 

( 

r 

( 

( . 
< ; 


Basic 1 can be identified by typing: 

►BASIC 

report 

Hie date '1981' Is displayed for Basic 1. 

Program Listing 11*1 

10 P-SM PURGE Viswst&r® deleted 

20 REM record rsmowt 

3D REM Tor B/Bi /M/C^ZF^E + viewstor* 

4 0 REK CO- Graham Bell 1387 
50 : 

60 REK VlsvstQre file constanta 
70 space! ™ 405 
00 e nd_G f_f1old% - 405 
SO end Of recordt = SOD 

loo endj^datal = 401 

110 delet-o^! = 402 
120 pad! * 400 

130 : 

140 ON ERROR pROCerrcr ( 0 ) 
lSO PRINT ■PURGE" 

160 : 

L 7 & prefix? - FNxiame {"Prefix tor data files’"! 

18C' najr,e3 = FNnejne i "Name of main database' 1 ! 

15D IF INSTRInfttflfiS, ". *) - 0 THEN rtameS = prefix? * “D-" + 

name? 

200 IF NOT Riqonfirrn {"Have you made a backup") THEN GCTO 330 
210 ; 

220 big file* = FNopen (name?* "IT) 

£30 big^eodt - FNebd_pol3lter (big_CIle%J 
240 ; 

250 FBI NT * "purging** 

260 + FX 229, 1 

270 records! - FNcompact file Ebig_riletJ 
280 IF PQS <> 0 THEN PRINT 

290 PRINT ; records!; " delated record.^! purged" 

3PD *FX 229 
310 ? 

320 CLOSE# big Ellel 
330 END 
340 ; 

350 i 
360 ? 

370 DEF FNcojBpACt_file 
380 LOCAL At, code! 

3 90 c*del = FNasseinble 
400 A* - filet 

410 - UtiSR crodEt) AND 4 FFFFQQ] 01 V 256 
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42 0 t 

430 DEF FNa Kemble 
44D LOCAL H, ¥\, suml 
450 osbyte = *FFF4 
4GO osaset = fiFFEl 
47p osgbpb - tFFDI 
430 i 

4.9D DIM addr &2FF 
500 FOR Ili » ^ TO *2FF 
510 3 %?Bddr - P 
520 NEXT 
530 : 

54 D FOE pass = 0 TO 2 STEF 2 
550 PI - addr 


560 

1 

OFT 

pass 

570 


STA 

Ipct ri 

590 


STA 

Opctrl 

590 

„ main 

JSR 

fill 

G00 

.maln_l 

J,DX 

ipptr 

610 


LDA 

ipbuf £. X 

620 


INC 

ipptr 

630 


CMF 

Ideleted! 

640 


BF.0 

main__3 

650 


CMP 

lend of record! 

660 


B&TE 

main 2 

670 


WK 

iastfcj 

600 


CPK 

• deleted! 

69-0 


BNE 

main_2 

700 


FHA 


710 


Wh 

146 

720 


JSR 

osasci 

73D 


PLA 


740 


im 

count 

750 


BNB 

main_3 

760 


INC 

count + 1 

770 


JMF 

ma tn_3 

700 

,jcain_Z 

USX 

□ppt r 

790 


STA 

opbuf l t x 

300 


INC 

opptr 

310 


BNE 

ifiain_3 

020 


PHA 


330 


JSR 

erupt y 

040 


PLA 


B50 

- ma ln_3 

STA 

lastb 

0 60 


LDA 

ipptr 

070 


BNE 

m.ain_l 

000 


BIT 

eoflag 

0 90 


BFL 

main 

900 


USA 

oppt sr 

910 


BEQ 

main_4 

920 


JSR 

empty 

930 

.main_4 

USX 

count 

940 


LDj 

count + 1 
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950 

RTS 


960 

i 


910 

Jill LDA 

#0 

no 

tDX 

PI 

990 

STA 

Ipctrl t 0 

1000 

STA 

ipctrl * 7 

1010 

STX 

ipctrl * 6 

102Q 

STA 

Ipctrl * 5 

1030 

LDA 

mo 

1040 

J5R 

exabyte 

1050 

STY 

ipctrl * A 

1060 

3TX 

ipctrl + 3 

1070 

LDA 

Hpbuff DIV 256 

106D 

STA 

ipctrl * 2 

1090 

LDA 

lipbuff MOD 256 

1100 

STA 

ipctrl + 1 

mo 

LDA 

13 

1120 

LDX 

tipctrl MOD 256 

1130 

LDY 

flpctrl DIV 256 

lUti 

JSR 

osgbpb 

1150 

RPR 

eoflag 

116Q 

BPL 

fill 2 

mo 

LDA 

10 

1150 

SEC 


1190 

SBC 

Ipctrl + s 

12 00 

TAX 


1210 

LDA 

tdeletedl 

1220 

.fill 1 STA 

LpbuffVX 

1230 

I NX 


1240 

BHE 

fill! 

12 50 

.fili_2 RTS 


1260 

■a- 

B 


1210 

-empty LDA 

to 

128 u 

LDX 

ii 

3:290 

STA 

ppctrl + a 

1300 

STA 

opctrl * i 

1310 

STA 

cipctrl + 6 

1320 

LD¥ 

□pptr 

1330 

SNE 

ecnpt^l 

134 0 

STX 

opctrl * 6 

1350 

,enspt 1 STY 

□pctrl + 5 

I960 

LDA 

H 30 

1170 

JSP 

asbyte 

1350 

STY 

cpctri - 4 

1390 

STX 

cpctrl * 3 

1400 

LDA 

fopbuff DIV 256 

1410 

STA 

opctrl 4 2 

1420 

LDA 

fapbuff MOD 256 

1430 

STA 

opctrl + l 

1440 

LDA 

*1 

1450 

LDX 

iapetrl MOD 256 

14 60 

LE>Y 

1 opctrl CUV 256 

1470 

JSR 

ofiribpb 
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) 


i4ao 


RTS 






1490 

1 







1500 

.ipptt 

OPT 

FWaqub 

m 




1510 

.oppt r 

DPT 

Ft-Tequh 

(0) 




1520 

lag 

OPT 

Ftiequb 

m 




1530 

.lastb 

OPT 

FRequb 

(03 




1540 

„count 

OPT 

FKequs* 

(03 




1550 

a 







1560 

,ipctrl 

OPT 

FRequb 

(0) 



% 

1570 


OPT 

FSequd 

i0] 



J 

1500 


OPT 

FNequd 

m 




1590 


DPT 

FKequd 

(03 




1600 

* op ct X1 

DPT 

FHequb 

(03 




1610 


OPT 

FWequd 

10) 




1620 


OPT 

F!*equd 

m 




1630 


DPT 

FSequd 

[0) 




1640 

■ 







1650 

.ipbutf 

OPT 

FNequs 

(STRING*fl20 t 

CFiRS 

on 


1660 


DPT 

FRequS 

(STRING*<128, 

CHR$ 

on 


1670 

^gpbuff 

OPT 

FNequs 

(STRINGS 020, 

CH*,$ 

033 


1600 


OPT 

FNequ s 

(STRINGS<127, 

CHRS 

on 


1690 

.end 

BRK 






1700 

) 







1710 

NEXT 








1120 s 

17 30 it end - a&it <> sZPfl THE'N PROCerror {3} 
1140 = addx 
1150 ; 

17 60 DEF Ftiequb (byte*) 

1170 ?P% - byte* 

1700 P* = Pt * 1 
17 JO = pass 
1800 ; 

IS 10 DEF FNequw (word!) 

1020 ?FS = wordl >»D 256 
103B Ffc?l - word* DIV 256 
1040 PI - P* * 2 
1050 - pass 
i960 i 

1070 DEF FNequd [dduble%) 

IflSO !P1 ■= double* 

1690 PI ■- F% * 4 
1000 = pass 
1910 ? 

1920 PEF FKequs £Etrinq$) 

1930 $P% = strings 

1940 PI = PI r LEW string^ 

1950 - pa =5 
1960 i 

3 970 DEF FNeorf_pO±nt*r 
1980 LOCAL ptrl, byte*. 

3 9 90 pt;r* - EXT# file* 

2000 REPEAT 
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2010 ptr% = ptr! - 1 
2D2G PTRt file% = ptt% 

203C byte! - EaGET# filet 

2040 UNTIL cbyte! O pad! I DR (ptr! = QJ 

20 GO REM only eod market may preseed padding in valid file 
2060 IT (byte! <> erjd_of_dflta%) OR Sptrt - 0) THEM PEOCerror(2) 
2010 = ptr! 

2DB0 : 

2050 0£F FNname (prompts} 

2100 LOCAL nafflifrS 
?U0 PRINT 1 prompt$; 

2120 INPUT H ? - na™e$ 

213-0 REM delete trailing spaces 
Zlfl0 REPEAT 

2150 IF RIGHTS(nameS, lJ - '* H THEN names = LEFTS (nameLEN 
nameS - 1) 

2160 UNTIL KifiKTS (names, 13 <> " " 

2lTC - nameS 
21B0 : 

2190 OFF FWconfirm {prdfflptSJ 

2200 LOCAL keyS 

2210 PRINT ' prompts? 

2220 INPUT " (N r Y) 7 * key* 

2230 keyS = LEFTS [key$. 1) 

2240 - DK9M-t”¥y" l keySi <> 0 
2250 j 

22 60 DEF FNopen (nuneS, controlS) 

2270 REM requires Basic 2 
22 0O LOCAL hartdle% 

2290 controls - LEFTSfcontrolS, LJ 
2300 PRINT "Opening ■; name$ 

2310 IF controls = fl R" THEN handle! - OPENlM n&meS 

2320 IF controlS - "U p THEN handle! = OFENUP name? 

2330 IF controls - *W M THEN handle! = OPENflllT niUneS 

2340 IF handleI = 0 THEN PRCCeffOf {ll 

2350 = handle! 

2360 : 

2370 DEF PRDCerrdr Jnumber!) 

2330 *FX 229,1 
2390 CLOSEf 0 

2400 IF number! = 0 THEN REPORT : PRINT 

2410 IF number! - 1 THEN PRINT "Can 1 ! find fUe H 

2420 IF number! - 2 THEN PRINT “File not a database* 

2430 IF number% = 3 THEN PRINT *Assembler error - pLease chock 

Jisting" 

£440 *FX 229,0 

2450 END 


Listing ; 11-1. I'USfiE deleted record remover. 
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The biggest single advantage of a large electronic database is the ability 
Eo create a summary of its contents quickly. This can t be done w ith a 
traditional card-based file because you would have in search through 
all the cards manually. Of course, the computer can do this searching, 
and it can sort the cards, or records, into order too, using the &ELECI 
utility. The next requirement Is to produce a summary of the 
information in the selected and sorted records VievvStore does this 
with the REPORT utility 

f rod urine simple lists from a selection file using the REPORT utility was 
described in Chapter 10. In a way, this is a summary of the records in 
the selection file, but it is always the first few fields in each record that 
get printed But REPORT offers much more sophisticated control over 
the summary, by using a report definition file. 

The report definition file specifies which of the selected record fields 
should be displayed, and also how each field is shown. Mathematical 
operations can be carried out on numeric fields, and totals and subtotals 
of particular fields can be be printed. The report file can also control the 
page layout of a printed report. 

Setting Up a Report Definition File 

In fact, a report definition Is another mini-database: it consists of the 
report file itself, and a special report format file F. RETORT. All report 
files use the same F.retort file This special file is supplied on the 
ViewStore utilities disc, and should be copied to any working database 
disc or directory along with the utility files. It should be on the disc 
along with any other format files, so the same prefix can be used For 
example, with two double-sided disc drives, the format files are usually 
put on drive two, and the prefix set to ':2.\ 
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]usi as with ,1 complete database, the setup utility is used ta create a 
new report file. The first prompt from this utility is: 

Create database or report (D,R) ? 

You should answer R' to make a report file. The utility then asks for the 
name of the report file. It's possible to use the same name as for the 
other database files; in this case P.bjuuog and F.BIBUOG would be joined 
by R.BIBLIOG, But it is also possible to have a range of different report 
files, to create reports on a number of aspects of the same data. Clearly, 
each report file needs a separate, recognisable name. 

DF5 One point to be care fill of when using the DPS is that the 

same U prefix is used for creating database files and 
report hies. 5o r if a report is created, it usually gets put 
on the disc after the end of the database file, This may 
leave the database file little or no room to grow as new 
records are added id it, and eventually lhe dreaded 'Can't 
extend' error message will occur. To avoid this serious 
problem, it is better if the new report file is created on a 
different drive, perhaps where the utility files are kept. 
For example, if the database file is in directory 'EY on 
drive zero and the utilities are on drive one, then the 
report file called MONTHND can be created by using the 
full name* 

^amE of report? ;1.ft.HOSTHND 

ff the full name is used like this, then the prefix Is ignored. 
Henceforth, because the standard D' prefix won't apply 
to the report file, the full filename w ill have to be used- 
This whole process is unnecessary for ADVS or on a 
network, because the 'Can't extend' error doesn’t occur, 

Before using the report file to produce a report, it has to be filled with 
data about how the report should took. To do this, the report file is 
treated like an ordinary database, A report file called MONTHN r r> can be 
loaded into ViewStore by entering the folio wing; 

load r.mo»thhd report 

The report file is always in directory R* and R must be typed in; if it isn't, 
then View-Store expects to load a database file from the D directory, 
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and of course, d.moistfhnd doesn't exist Typing in report means that 
ViewStore uses the filename h. report with the appropriate prefix:, to 
load the special report format file. 

DF5: The fu]] report filename 1 :l.R.MONTPBW should be 

used if the file was created as above. 

The Report Definition 

Pressing ESCAPE after loading the new report file presents a screen like 
that in figure 12,5; this is the re;wf format definition , but its structure 
resembles that of a database. There may be any number of rows in this 
database. Each has just four columns known at T\ T-Lalfr, 'Half2' and 
'Field list'. 


t 3pie* 3QQ LntbE*d by 
Typ* CC-c-^m*nt, EHibalmi f ,1 


W 


rwBrd. S-mArtot*!,t^tatij | 


T.pilCl. T „ TT *„,„ ______ 

Figure 12.1. Initial blank report definition. 


Layout Types 

The T field marks the lint type. There are seven different types of report 
line, and the prompt for the line type codes Is shown in figure 12-1. The 
simplest line types are the two that control aspects of the page layout: F 
and M. 

A P-type line changes the page length of the report. If continuous A4' 
sized paper is used tu print the report, I hen the page length should be 
set to 70. There is room for 71) lines per sheet with a normal printer (70 
lines of a sixth of an i nch is 11 \ Inches}. The page length is put in the 
Half! 1 field: 

T.Half1 
P 70 

ft won't necessarily look like this on the screen. When the cursor is 


) 
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moved to the Tlalfl' field, the screen scrolls, so the T field can't really be 
seen. Putting in more than one P line is pointless, as only the first is 
obeyed- However, this line can be anywhere in the definition- Without 
a P line, a page length of 6b is assumed, and this is a suitable lenglh for 
most normal listing paper. 

An M line controls the number of blank lines left as a margin at the foot 
of each page of a printed report. The default margin is four blank lines, 
which usually Wt enough, [t can be increased in the same way as the 
page length- 

( 

T a Half 1 „ .---***+*.*+ 

m 10 

c 

Record and Header Types 

The bulk of a printed report should be made up of record Irbies, These 
tines' T field contains K\ As the report is printed, the record line is 
printed for each record in the database. Of course, this can be limited to 
one for each record m the selection file. 

Field Half! of a record line contains the text that should be printed for 
each of the records in the database. Within the text, there may be gaps 
marked by the special @ character These gaps, or patterns or formats, 
can be replaced by information drawn from each of the records in the 
database whde the report is printed, 

( 

Header tines, type H', contain the text that should appear at the top of 
each page of the printed report For example, if each page should be 
headed by a title giving the name of the report, then that name should 
be typed onto s header line. In fact, just like record lines, header lines 
can contain patterns too, and information can be drawn from the first 
record on each page to fill them, 

But let's start simply, try setting up a report definition like that shown in 
figure 12-2. First use the SETUP utility to create a report file called, say, 

( first. Load it with: 

LOAD R FIRST RE?ORf 

Then type in the text shown in the figure. Notice that there are two 
header fines. The first contains text and a pattern; the second is blank. 


( 
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This means thni at the head of each page a line is printed first with some 
text and then a blank line, 

T.Halfi.,,.. .,, - + , > *__ * 

* X2 

Bw&deir lln* for page fcelS 
H 

ft record line for record *@11 @ 


Figure 12.2- A simple report demonstration. 

What should fill in the two patterns in the H and R lines? Fut I he cursor 
on the first of the header lines, and press right. The Half2 f field is 
scrolled on. Press RIGHT again, and the 'Field list' field appears, Tills is 
a list of the information that should be printed instead of the patterns 
In this simple example, type ' IF into the field list. IP is a register, a 
number that the report utility remembers. In fact there ore 50 of them, 
but two have special tasks, ! P is the page register, it counts the pages in 
the report as it is printed, VIEW has a similar page register. IR is the 
record register counts through the records one by one. Put I R in the 
Geld list for the report line. (Note that J I' is shift-\ k The completed 
field lists should look like figure ] Z.3. 

Once the report definition is complete, pressing ESCAPE returns to 
Command mode and saves the details of the report definition in the 
report file. 

Wield Uat. *____»..,_ 


p 


I ft 

Figure 12.3. Report demonstration field list 

Printing a Report 

To print a report, the database must be loaded. Any database is suitable 
for the simple demonstration using the report definition in figure 12*2, 
but in particular the ViewStore 'CARS* example database or the CRHDtr 
database on the disc accompanying this book may be used. 
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First, load the database, and use the SELECT utility to make any selection 
necessary. For example, selecting all the records in the database in 
which a particular field has been filled in: 


Select criterl-VV Amount <> 

The double quotes denote a blank field. 

Once the selection is made, change to a screen mode which leaves 
plenty of memory free, because reporting requires a large amount of 
space Then run the REPORT utility. Answer the usual selection file 
prompt and then indicate whether the report should be printed out or 
merely shown on screen. If a printer is connected, then answer *F. 
Type S' to merely see the report on screen. The third prompt is shown 
below: 


Use report format file iM,TJ7 

Answer J Y', then enter the name of the report file, FIRST. The rest of the 
prompts can be ignored by just pressing RETURN to give their default 
answers. The whole process is shown in figure 12.4, and the printout 
of the second page from the report itself is in figure 12.5. This will look 
the same whatever database is used to generate the report. 

- 1 >LOAfl SIBLIOG 
>UTILITY REPORT 

use'select file (N,Y|? 8 

screen or Fainter (S r pj? P 

Use report format file (N r ¥J7 Y 

Report filename? FIRST 

Send totals to linking file (N,YI7 

Subtotal field? 

Single sheets (K,T)? 

-> 

Figure 12-4. Printing out the simple report. 
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) 


) 


> 


Figure 12.5, A single page of report print-out. 

With the printout to hand, look back at the report file that created it. 

First, on the page are the two header tines, one with text, one without. 

The pattern from the first header line has been replaced by the 

page number taken from register IP. Following the header are a 
number of record lines, one for each of the records in the database 
These are numbered because the value of register IR, the record 
counter, Is included on each line. Finally, at the bottom of the page are 
four blank lines, the default margin. 

Another detail can be learned from this simple report- Notice that there 
are big gaps before the numbers. This is because the numbers are 
ranged to the right within the pattern, so; 

) 

header line for page 
becomes the following: 

header line far page 2 


header 

line 

for 

page 

2 

record 

line 

for 

record 

1 

record 

line 

for 

record 

a 

record 

line 

for 

record 

3 

record 

Jin « 

for 

record 

10 

record 

line 

for 

record 

11 

record 

line 

for 

record 

12 


A More Complex Report 

The new report definition shown in figure 12.6 illustrates a number of 
new points, it is designed to be used with the CREDIT database on the 
Dabhand Guide disc, but the principles can be used with any database 
However, at this stage it is useful to have a printed list of the 
fieldnames used in the database For which the report is imended. 
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Load ihe database, connect the printer, and type in the following: 
CTRL-a LIST RETURN CTRL-C 




T.Half 1 


ti raqs «« 

H 

H 

X 

H id 
p EC 


HUM Ol lillHli rfftfBH-l'fl 

fui Hii*m9Mia»se»fl!»tge 


Figure IZ6. Complex report definition example. 


In figure 12.6, the most obviously new feature Is that there are several 
patterns on the record line, and that they are much bigger. These 
patterns are designed to be replaced by information from the database 
rather than the numbers from the registers. The Field list is just what it 
says a list of fields from which to take information. So the field list for 
the record line could be: 


Company r Invoice, Bate, Amount 

The order of the fieldnames is important. The order the fields appear in 
the list is the order they get used to replace the patterns. This means 
that the record line; 


invoice amMeete of eifcascBfl esssm.s! 
might eventually be printed as^ 

Systematic: Pip invoice 1^01234 of 25 . 5.06 f. 24 . 

The Company information goes in the first pattern, the invoice number 
in the second, and so on. It's important to make sure that the number of 
items in the field hst matches the number of patterns there are in the 
record line's Half 1 field, and th.it Ihe different types of field match up 
with their intended patterns.In printing out a report, if the error 'Not 
enough fields 1 occurs, it really means there are too few patterns on the 
stated line in ihe report definition. Too many patterns doesn't cause an 
error; the excess patterns are merely ignored. 
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The various parts of the field list are separated by commas, The 
Held names in the field list must be typed in carefully. As usual with field 
names, the question mark (?) and star (*) wildcards can he used, but 
unlike other uses of wildcards, any abbreviated field name must be 
unclosed in delimiters, like this; 

Company, Date,. "Arne*" 

Delimiters are also needed if the fieldname contains a comma or other 
odd character, or even if the fiel name contains a space. Delimiters 
should preferably be double quotes H or single quotes 1% other 
punctuation characters can be used if necessary. 

As the record line is a mixture of text and patterns, some of the print¬ 
out is text printed literally, other parts are taken from the database 
The length of the pattern controls how much of the database 

field gets printed. In this case, there is room in the pattern for 
'Systematic Pip'; the full company name is actually longer but is 
truncated because the pattern is only 14 characters long. 

The final pattern contains a decimal point. This is only useful when the 
corresponding field is a numeric type, but it controls the number of 
decimal places uted when the number is printed in the report 

In fact, there are two record lines in figure 12.6, t he second has another 
pattern on it, for which the field list is 'Stores ltem(s) r . This means that 
each record in I he database will produce two lines of report, like this: 


record 

line 

a 

for 

record 

3 

record 

line 

b 

for 

record 

3 

record 

1 ine 

a 

for 

record 

4 

record 

line 

b 

for 

record 

4 

record 

1 ine 

£L 

for 

record 

5 


Again, it doesn't matter where within the report definition the two lines 
are, but the order they are primed in is the order they appear. There 
can be any number of record lines. It is sensible to keep them all 
together in the definition, or one may get overlooked. 

Registers and Arithmetic 

The REPORT utility is the only part of ViewStore that can carry out any 
sort of arithmetic. For example, if the database figures Include vat but 
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( 


( 

i 

( 

( 

( 

( 

( 

c 

( 

( 

« 

( 


the invoke amount in the record line above should be quoted excluding 
VAT, then the field list could be amended to: 

Company* tnvolc*. Date, Amount / l A5 

Then the pattern in the record tine gets replaced by She newly calculated 
VAt-free invoice amount* The calculation is done separately for each 
record in the report . 

Addition, subtraction and multiplication may be used as well as division, 
and brackets can be used to ensure that complicated expressions are 
calculated in the right order. Obviously, if a fieldname is used* then the 
corresponding field must be numeric! Ef il isn't, then a Type mismatch' 
error message will appear on screen. Sadly, even dale fields can't be 
used, so time intervals cannot be calculated- 

Calculation results can also be assigned to registers. Two registers 
have already been used, ! R and I F, but these are the odd ones out- It is 
unwise to do anything w ith them excepl print them out, as in the simple 
report definition in figure 12-2. All the other registers, IA to IZ, are 
accumulators. Look at the following series of assignments. To start 
with look ah 


AjIO 
ft: 2® 

A:5 

A i Amount / L H 15 


makes i A = 10 
makes I A =30 
makes !A = 35 

makes i A = 35 + (Amount / 1.15} 


Each new figure assigned to IA doesn't replace the current value; it is 
added to it instead. 'AT doesn't make I A=1, it increments I A by one. 
This Js quite unlike variables in BASIC or other programming languages, 
where the equivalent is: 


A “ A + I 

One perplexing source of errors is that you can't use spaces around the 
colon in a register assignment. 


( 

tAV-M 

i 
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A Report With Subtotals and Totals 

So what are registers used lor? Most often., they arc used to 
accumulate subtotals and totals of numeric fields. The report definition 
to figure 12,7 could use the following field lists far the two retard lines: 

Company, Invoice* Date, Amount* A:Amount 
■Stores item(st" 

This uses the register IA to accumulate the Iota] of all the invoices in the 
database. As each record line is printed, its invoice amount is added to 
I A. 


... 

n 

a #i 

K 

P UmvUm --■( EEeees*e utEta-K 

P Cite B*BB H*I 

3 - 

Siltattilmd EJPMI.I# 

s ■. 

a 

T —- --- 

T mum TOTAt ME 3 

7 — --■-- 

ft la 


Figure 12.7, Report definition with totals and subtotals. 

To print out the invoiced total at the end, a total line is used. This has a 
T field containing T* Tn fact there are three total lines, two being used 
just to highlight the real total, The lot art lines get printed right at the 
end of the report, after the record lines for the' whole database have 
been finished. 


There is a single pattern in the main total line, and just like a record line, 
it requires a field list. In this case, the field list would be as follows: 

fTA 

The pattern gets replaced by ibe value of ! A when it is printed. And I A 
contains the total of all the invoice amounts. So: 
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T ——-——----—-- 

T GRAHD TOTAL OWED 

becomes the following: 

T —-———--- 

T GRAM? TOTAL OWED £ 1604-07 

T---—-™ ■“■—— —---- 

Figure 12,7 also used four subtotal lines, type S\ These can be printed 
out part way through the report. The way this works is as follows. The 
report utility prompts for one or more subtotal fields. If a Field name is 
entered, then ViewStore keeps an eye on the values in this field as the 
report is printed. Every time it changes, a set of subtotal lines is printed. 
The overall scheme may look like this, if the Company field were used as 
the subtotal Trigger ; 

Ball £ CO. 

—Subt-Gfeal- — 

Systematic Pip 

5ystt?jnatic Pip 
Systematic Pip 

-Subtotal-— 

Therm-Ace HdAC 
Therm-Ate Heat 

-Subtotal—— 

-Total —- 

Each accumulator register is really two separate registers; ITA 
provides the total stored in the IA register, and ISA provides the IA 
subtotal. The difference is that the subtotals are all reset to zero every 
time a set of subtotals are printed. So, just as total lines should contain 
patterns and field lists using I TA, ITB, or any other register, subtotal 
lines should use I SA, I SB arid so on. 1 SA contains the total since the 
last set of subtotals 

Subtotals are only really useful if they are used with a selection file 
sorted into order. If the selection file was sorted using the Company 
field, then the selection trigger should be the Company field too. If the 
companies were not in order, then useless subtotals would be printed 
after almost every record. 
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The whole process of producing a report using the credit database is 
shown in figure 12 A The aim is lo produce a summary of all the 
invoices received during one particular month, A selection file is created 
that contains all the records where the invoice date is during May 1986. 
This is then sorted into alphabetical order of company. Then the report 
utility is used, with a report file like that in figure 127. The Company 
field is used as a subtotal trigger Part of the printed report is also 
shown, in figure 12.9. 

= >LQAD rafttit t 
>RXUH SELECT 

SELECT List or create Ml«3t flic (L,F)? r 
Select criteria? PATE 1.5. fit AND DATE < 

Select criteria? 
sort Held? COWAKY 
Sort field? DATE 

Sort field? 

Key vldthi E> 

Ascend or Descend (A,D )? A 

Selecting. __,,,,,,,*,,********, 

13 records selected out of 2 A 
SORT 

Sorting--. - 

= >VTILXTV REPORT 

REPORT 

Use select file £H,YJ? ¥ 

Screen dr Printer (S,R>? ? 

Use report format file (Ni¥)? ¥ 

Report fsLen^Hie? : I, R .FIRST 
Send totals to linking file (H, Yi ? H 
Subtotal field? COMPANY 
Subtotal field? 

Single sheets iN.Y)? M 
=> 

Figure 12.8, Generating a complex report 
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Page 3 


Systematic Pip 

invoice 

DH981 

of 21,5,0* 

£ 

35,09 

for Polypropylene Hose 





Subtotal awed 




£ 

395,10 

Therm-Ace 

Heat 

invoice 

€0000004 

of 0.5.fit 

£ 

IS, 25 



for 

topper Fitting? 



Thetm-Ace 

Heat 

invoice 

00000005 

Of 13-5,66 

£ 

12.35 



for 

Moulded Elbaws 



Thenn-ACe 

Heat 

Invoice 

00DOC00E 

□f 23.5.86 

£ 

5.43 



far 

Moulded Y 

P tecCH 



Theitn-ft.ce 

Hest 

Invoice 

00000007 

of 21.5,86 

£ 

17.11 



for 

Kouided Attachments 



The rm-Ace 

Heat 

invoice 

G0QQ0QG0 

□f 31.5*0fi 

£ 

4.98 



for 

Moulded Sundries 



Subtotal ■ 

□wed 




£ 

115,16 

TOTAL OWED 




£ 

1410,86 


Figure 12,9, Part of printed report. 

There is a major weakness with the sub totalling procedure. If the 
subtotal line contains any patterns and the field list refers to fields from 
the database, then the information comes from the first record after the 
subtotal r nol the one before it. So a subtotal line like this: 



s Subtotal owed 




would produce a report like this: 





( 

Systematic Pip 

invoice PH927 

a£ 

12.5,06 

£ 

123.45 

Systematic Pip 

Invoice &H961 

of 

21.5,86 

£ 

as.ee 


Subtotal owed to Therm-Ace Heating 



£ 

39S-10 

( 

Tha ra-Acfl Heat 

invoice 00000004 

Of 

0*5+06 

£ 

76.29 


Therm-Ace Heat 

Invoice 00000005 

of 

13*5+06 

l 

12.35 


Clearly the information on the subtotal line is wrong. To avoid this 
problem, field lists on subtotal and total lines should not refer to 
database fields, only to registers 
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Number Formatting 

The role of the pattern is fairly dear with text fields; it controls 

the maximum length of the information in the report. If the database 
contains a field which Is longer than the pattern, then the text is 
truncated. The pattern may only contain © characters. 

With numeric fields, the pattern can be more complicated. It may 
contain a decimal point, and it shows how many decimal places should 
be shown in the report. For example: 


m. 00 

shows 0 as 

<1*08 

MB-00 

shows 3.1 as 

3,10 

aee.ee 

shows 1,109,000* as 

1.11E6 

eee 

shows 6.1 as 

6 

80.0 

shows 1,109*000 as 

1 


The error in the last example is caused because the pattern calls for one 
decimal place There is no room for 11 £>9000.(3, so the equivalent 
exponential form is used I Jowever,. there is no mom for 1 1E6 either, 
so *%* signals an error. When reducing the precision of a number for 
display, ViewStore rounds properly, so 4,49 becomes four, whereas 4.50 
becomes five and 1,109,000 becomes lllEte 

The last option in a numeric pattern is to use J b' instead of the © 
character: 


ybb.bb 
■9bb,bb 
flbb.bb 
Mi ..0b 


Shows 1,1 as 
shows l ,]09*000 as 

shows D AS 
shows 0 35 


3,10 

1.11E6 


The formatting works exactly the same, except that it the number is 
zero, then only blanks arc printed- Only a single b is needed, and it can 
be anywhere in the pattern except the first character. J B' can be used 
too. But il is conventional to use an initial © and make the rest of the 
pattern from b characters- 

Using HaL£2 

Report? created in the usual way are limited to a width of 79 characters. 
This is because the Halfl field used to type in the report text and 
patterns has a width fixed at 79 characters, and it can't scroll. For wide 
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printers, or normal printers used with condensed mode print, another 
held, IMf2, can be used to define What should be printed on the right- 
hand half of the paper. 

E*tra text or patterns typed into Hulf2 act in all ways as a simple 
extension of Halfl This can pose a couple of unexpected problems. 
Figure 12,10 show?: two record lines, together with an example of how 
they would appear in a printed report. 

Hal f I...Halfi.. 

Imraioe nuinb^r Date 

ATiaunt LGb&b.&b VAT £&bbb.bb 


Ijivglee number 1234Date 24-7.07 

Amount £ 11.50VAT £ 1*73 

Figure 12.10. Using Half2- 

Notiee that there is no automatic gap between Half! and Half2 when 
the report is printed- 'Date' is printed out Immediately after the 
number, filling the invoice pattern from Halil. And although Vat is 
aligned under Date" In Half2, they are not aligned when printed out, 
because their respective Halfl texts have differing lengths To mak# 
this work, Halfl must be padded out with extra spaces, as shown in 
figure 12.11. 

Hairi... t2 . 

invoice mtnfcer 0@§fl«#* Date eBHGtte 
Amount IQbbb.bb##MR111 VAT £fibbb.bb 


Invoice number 1234 Dare 24*7.fl7 
Amount t IX *50 VAT £ 1.73 

Figure 12.1 L Using Half2 properly. Extra space - 

The second problem can be caused when Halfl ends with a pattern and 
Half2 also begins with a pattern. Because there is no space between 
them, the RETORT utility treats them as a single, long pattern. 
Consequently, the last field in the field list has no pattern, and it never 
gets printed. The solution to this is to ensure that HaJfl always ends 
with at least one space character¬ 
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Comment Lines 

One of the major advantage of the VtewStore reporting system Ls that 
when it's decided what sort of a summary is needed, and the report 
definition file created, the same start of summary can be done repeatedly 
just be re-running the hitpoft utility. So every month, a series of month- 
end reports can be generated with the minimum of fuss. But then the 
report for April will look identical to the report for May 

Comment lines are a way of incorporating something unique into each 
report, A comment presents a prompt every time the REPORT utility is 
used, and the answer to the prompt can be "printed in the report, for 
example, the report date could be printed at the head of each page. 

A comment line is type 'C. The prompt text can be put in the Half] field: 

T-HalfL*._* „ . . 

C Today's date? 

The Today's date?' prompt becomes the last prompt that the utility asks 
before generating the report. Whatever is typed in response Jo the 
prompt becomes comment 1, or iA CT. A second comment line with a 
different prompt could supply a third A C3 and so on. 

The response can be printed m the report by including A C1 in a field list; 
of course it needs a corresponding pattern lex?, A header line like this: 

T. Half J., I + * .... .. . . *..HaLf£*. + + *. Fiald Hat. 

H Summary dated *ci 

could be used to print the date of the report at the top of every page. 

The responses to comments are always treated as plain text. Dates 
don't need to follow the VkrwStore convention, so for example, 

'8th August 1987' can be used instead of 'EJ.87 r . Note that numbers 
typed in response to a comment prompt can't be used in any arithmetic. 

Reporting on VIEW 

The page layout features of the RETORT utility are fairly rudimentary. IT 
greater control over the layout is required, if the report needs to be 
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annotated, or if it hag to be incorporated into a larger overall 
document, then the report must be saved to a file, not printed. 

The report can be sent to a text file using the V^XFEK spooler described in 
Chapter Six. VSsFLR is a printer driver, and it can be loaded into 
VtewStore with the PRINTER command before using the REPORT utility. 
When the report is created, a filename must be entered in answer to the 
'Spool filename T prompt, 

Eventually, this new file can fee read into VIEW and treated as normai 
Notes can be added, and all the page layout facilities of view used to 
print an attractive report. 

A tip worth remembering is that a spooled file really shouldn't be 
divided up into pages. If it is, then the extraneous blank lines and 
header lines might need to be removed when the file is read into VTEW, 
The REPORT facility normally does divide a report up into pages, with 
the header lines at the top of the page and the margin at the foot. 
Paging can be switched off by setting a page length of zero in the report 
definition, as below, so no extra lines are created: 

T.Half!* .. 

F 0 

Actually, this sets a page length of 256 lines, I he maximum length that 
can be used. So for exceptionally long reports, a few r extra lines may be 
created as a second or third extra-long page is required. However, this 
minimises the amount of editing that needs to be done once the report is 
transferred to VIEW, 
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Using a !BOOT File With ViewSheei 

When starting up VicwShcet, ihe same sequence of keypresses is often 
used to set the printer up, to select a favourite screen mode and colour, 
and so on. This whole sequence can be speeded up and made more 
convenient using an exec file. 

An exec file is a file which Is read in from disc or network, and simulates 
keypresses or commands entered at the keyboard. Any command in the 
file is executed just as if it had been typed in by hand. The most familiar 
example of an exec file is the !BOOT file that is often used to start up an 
application or game by pressing SHIFT-BREAK. This procedure is called 
auto'boo ting and the fib itself is sometimes described as an autoexec 
or auto-boot file. 

Creating an Auto-exec File 

The usual way to create an exec file is to type in the *bU3LD command. 
But an exec file is realjy just a text file, so almost any wordproeessor can 
be used Try to ensure there is no formatting of the text file, or any 
extra matter In it. The program to be careful with is InterWord, 
because it saves all the setup preference data at the beginning of each 
file, and so a normal saved tile can't be used. The spooling option 
offered by InterWord and most other wordprocessors is ideal 

An ordinarily saved view file is fine, providing there are no rulers, nr 
edit commands. Tt is best to switch formatting off as well (with smin I 
on VIEW version 3 or later, otherwise press CTRL-f2), before starting to 
type in the file; this prevents any long lines being split up or justified. 

The 'boot file is a special type of file that can be executed automatically 
when SHIFT-BREAK Ls pressed. This could include all the commands 
regularly used when starting up ViewSheet Here is how to create a 
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typical iBOOT file using *BUILD. The line numbers are provided 
automatically by the computer, and dont appear in the final file; 

*BtlIU3 ■ BOOT 
0001 *TV 0 1 
00 QZ »SHE£T 
0003 MODE 3 
DC0J PJUfJTER JUKI* 

0005 LOAD <filsnjuno> 

0006 LH <windowfila> 

0007 ESCAPE 

This same text could be typed into view or another wordpracessor just 
as easily, and saved in a fi fe called iBOOT. 

When executed, this IBOOT file switches off video interlace so that the 
display doesn't jitter up and down on a monitor, then selects ViewSheet 
and changes screen mode, Then it loads the printer driver, the 
spreadsheet model and a set of window definitions. Hressing ESCAPE 
completes entry of the *euiLD file. 

The file can be executed at any time by typing: 

*EXEC f BOOT 

but to make the file auto-boot, the following has to be entered too* 

*OFT 4 3 


This stores in the disc catalogue the information that (he fBOOT file must 
he executed automatically, whenever SHIFT-BREAK is pressed. 


Tape: 

A cassette-only BBC model h micro does not provide the 
tBUILD command. Exec files can only be written using a 
wardproecssor, and can't be auto-booted by pressing 
SHIFT-BREAK, 


Net: 

An auto-boot file can only be put in the user root 
directory &. This is the directory reached with the *i am 
command or with +DfR. Consult the network manager 
if in doubt 

) 

Exec files such as iboot can also include commands to change the screen 
colour; this is explained a little later. 

) 
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Special Effects With Printer Drivers 

The Acorn Printer Driver Generator can be used to create 
extraordinary printer drivers that allow unusual effects to be used for 
special ViewSheet models The essence of the technique is to iie to the 
generator The special effects can he applied at three levels. 

Whole Sheet Effects 

The first type of special effect relates to the whole printout* 

One of the difficulties of using spreadsheets with many printers is that 
models may exceed the maximum width of the printer Most printers 
used at home are only 80-columns wide. Using a dot-matrix printer, 
this restriction can be lifted by selecting a capf/ciiscd ftitti which usually 
gives up to 132 characters across the paper on an SQ -column printer. 

The condensed font must be switched on before printing commences by 
sending the relevant control codes to the printer. 

This can be achieved by specifying the necessary control codes when the 
generator requests the codes for printer initialisation. For example, the 
following answer wtU make an Epson FX8€ or compatible printer set 
condensed mode when the printer driver initialises it: 

Include printer inttl^lisatiDn? Y 
Give cede sequence for Initialising the 
printer:!SC "I" 1 13 

The E5C H 3 1 is the standard initialisation code for an FXSO or 
compatible printer. It allows the pound sign to be printed using control 
code 6, The extra code 15 sets condensed mode, 

This initialisation code is sent by the printer driver to the printer every 
time printing begins. Other effects can be selected in a similar way; ihc 
printer could be set to near letter quality mode for example. If 
necessary, complex sequences of up to a maximum between seven and 
21 separate codes can be entered into the initialisation routine (the 
actual maximum depends upon which cedes are entered! ). This allows 
ample scope for setting bizarre italic enlarged bold fonts if necessary- 
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Window Effects 

Another type of special effect relates to the whole of a printer window. 
Highlight options one and two are normally attached to a printer 
window definition, and cause that particular window to be printed in 
bold face, or underlined. If for example,, a combination of bold face and 
italics is needed instead, then press Y in reply to ihe generator's 'Include 
underlining?' question, but remember to give the codes for italics when 
the generator asks for the underline on and off codes. Answer the other 
questions in the normal way: press N in response to Include italics?'. 
When this special driver is used, highlight option one will print italics, 
even though the driver actually thinks it is switching on underlining. 

Single Character Effects 

Lying about the ASCII code that prints hash, dollar or pound signs, 
allows the printing of any single special character that the printer 
provides. Simply put a hash on the shoot- The driver wall use the 
altered code, and the printer will print the special character. Far 
example, a degree symbol can be printed on an Epson FXSO or 
compatible printer by specifying code 5, 

Special Effects Without a Printer Driver 

Another good way to set whole sheet effects is to use an exec file- An 
exec file can contain control codes, and these can be used to set special 
fonts on the printer. The advantage of using exec files is that the same 
files can be used with all languages, not just the VIEW family. 

Obviously, BASIC- or Pascal don't use a VIEW family printer driver when 
printing, but an exec tile that does something lo the printer can be used 
[n exactly the same way in basic, Pascal and VicwSheet 

Breaking the Code 

Short exec files are usually written using ♦build, but control codes can't 
normally be inserted into the file The Master series micros have an 
enhanced version of ♦BUILD which allows control codes, IA is the 
equivalent of ASCII code 1 orCTRL-A. Tills coding may be familiar from 
function key definitions, which often contain 1M to mimic RETURN (that 
is ASCII code 13). ♦build doesn't allow editing of the file, which can be 
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a problem if the exec file doesn't work as expected- An alternative is to 
use the Master screen editor, host. By using this, control codes can be 
inserted into a text fUe simply by pressing CTRL-A, for example. One 
slight difficulty with EDST is inserting the ESCAPE code. As EDrr usually 
ignores this key, the way to do it is to use some unique word to 
represent ESCAPE in the text, such as XESCX, then at the end, type: 

f5 'Global replace: XESCX/11'- 

EDIT is only included with the Master 128. Producing special exec files 
containing any type of control codes can be made easier on all BBC 
micros. The decode program is the thing to use. It reads a normal text 
file written by VfEW or any other wordprocessor, and converts it into a 
special exec file. Control codes can be put in the text file in a special 
coded form (IM for RETURN and so on as previously mentioned}, and 
they will be inserted into the exec file in decoded form. 

Using DECODE 

To use DECODE, type in the BASK; program in listing I at the end of the 
chapter, and save it; a suitable filename is PECOsrc. Then run the 
program. It will assemble and save a machine code file called decode. 

This decode machine code program can now be used to read any text 
file and convert it to an exec file. If the text file contains control codes in 
coded form, these are decoded and put into the exec file. To do this, 
type in the following: 

"DECODE <teJct-fil*> <cxec-fllfl> 

giving the names of the old text file and the new special exec file. The 
DECODE program reads in the text and converts it Into a new exec file. 

If the exec file doesn't work as it should, then the original text file tan 
simply be reloaded into a word processor and edited. Finally, DECODE 
should be tried again. DECODE won't overwrite an existing file, so delete 
the non -working copy of the exec file before re-ru nning DECODE- Once 
the exec file works properly, it can be used quite independently, but it is 
a good idea to keep the original text file somewhere in case additions 
need to be made later. 
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Using DECODE this way may destroy any other text or programs stored 
in the machine as it uses a chunk of normal memory to run in, and store 
data. 50 save any current work first before using DECODE, Altering lines 
150,160* 170 and 1600 as shown in the listing at the end of the chapter 
prevents this destruction, as the DECODE program then runs in memory 
normally used for cassette input, function keys buffers and user defined 
characters. These changes are not recommended with networked 
Master series machines, nor with 6502 second processors. DECODE does 
not work with the cassette filing system. 

Condensed Mode Printing 

DECODE can be used to create an exec file to make the printer print m 
condensed mode. Figure 13.1 is the original text that should W typed 
into VIEW or another word processor and saved, perhaps In a file called 
'CQNDsrc'. 

i& 

1*10 

1C 

*| | Cpnd.en.se-d print on Epson printer |M 
*|| tC) Graham H&lt 19S3 jM 

Figure 13.1. Coded exec file for condensed print 
decode can then be used to Create the final exec file. Type: 

‘DECODE COMDarc GODDESS 

The new CGNDEN5 file can be used to set condensed mode on all Epson- 
compatible dot-matrix printers. Before printing a model from 
ViewSheet which is over SO character* wide, ensure the printer is 
connected and type in: 

*£KEC COJiUE«$ 

The printer should now be ready to print up to 132 condensed characters 
across the paper. The normal ViewSheet print command can be used, 
and the model will be printed in the condensed font. 

Master Series: *EXEC CQNPEN5 can be shortened to *conpj : ns, because 
files can be executed automatically. This takes 
advantage of the facility whereby *RUN is the 
equivalent of *tf\EC for any file that has its execution 
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address (the second address that appears after tINFO) 
set to ^ffffffff. This feature is also supported on the 
BBC model Bby the Watford Electronics Disc Filing 
system. 

GONDENS can evert be used with a normal view printer driver, providing 
the printer driver does not reset the printer and cancel the effect of 
CONPF.N5. The initialisation code to avoid for most dot-matrix printers 
IS ESC *©". 

Pound Printing Problems 

The hash, dollar and pound signs are, as we have seen, a source of 
problems with printers. Figure 13.2 lists a text file that ensures that 
these problematic characters are printed correctly, even without a 
printer driver. It is for the popular Epson FXSO, Kaga/Taxan or Canon 
printers, I hough it may work with others too These printers have a 
rede finable character set held in RAM (often called the downloadable 
character set). The exec file selects the American character set so that 
hash and dollar print correctly, then redefines character 96 to be a £ 
shape rather than the grave accent O the printer usually uses. 


in 

I A | h ARiiMG 

IA| [ S A: IA1 @ | AE 0 I Aj @ 

I A | [|AtlAiA|Aie 
I A I l IAS IAI0IMIM 
I A | ! | J | AI R ? A I y LA - I A I 3 » 0 | A I R 
|A| L | £ | A | R | A | ! | 0 [ AB | A E Q I A j £ 

|C 

*I| t I 5 on Epson FX0O printer IM 
*|l iCJ 1990 Graham Bell IM 

Figure 13 2. Coded esec file for defining a pound sign 

Type the text into VIEW or another wordprocessor, and save it: 
'fbuNsre or a suitable filename. Then use decode as previously 
described to create art exec file called 'POUND 1 After lhat type in: 


-exec po mm 

which sets up the printer to use all the hash, dollar and pound 
characters correctly. Do this before printing your mndd You can also 
use both found and cgndens together. 


V4V fc 
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The use of POUND need no! be confined to ViewSheet U is of equal use 
for printing BASIC 3 Is tings, where hash and pound signs often get missed 
up in keywords like SOFT#, Simply execute the POUND file as above, 
before using the printer in the normal way. 

Bespoke Exec Files 

decode can be used to create special exec files to achieve other effects. 
First, find out hens to do the fob in bastc, using vou to send characters 
and ASCII codes to the printer. As an example, the BASIC program to set 
pica pitch and near letter quality (NIjQJ mode on a Canon PVVIGSO or 
Kaga/Taxan 810 dot-matrix printer Is: 

10 VDU 2, 1, 27 , l r RSC "F- 
2Q VDU 1, 27, 1, .ft SC "j" p 3 

These printers don't select near letter quality in quite the same way as 
Epson printers- The equivalent on a truly Epson-compatible printer 
capable u£ NLQ printing is: 

10 VQU 2, lr 27 . If ASC |K P |h 

20 VBtf 1, 27 , 1, ASC “x% 1,. 1, 3 

Once the necessary VDU codes are known, their equivalent?can be typed 
into a text file, using figure 133 as a guide Therefore the two sets of 
basic lines above become respectively: 

|BfA(||AP 
I A! MMiC 

or alternatively: 

IBIahiaf 
|A| [ IAK|A|ALC 

Any wordprocessor can be used to create this text file, which might be 
called r NUQe rc 1 + In the wordprixessor file, there should be no 
formatting of the text, nor any embedded control codes. 
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ASCII code 

ASCII 

Cdd& 

string In 


In 

hex 

text file 

0 

0D 




1 - 26 

01 

- 

1A 

|A - IS 

27 

IB 



1 1 

2S 

1C 



l\ 

29 

ID 



M 

30 

IE 



r 

31 

IF 



1 

32 

20 



SPACE/ 

33 - 126 

21 

- 

7E 

l ' - 

127 

IF 



n 

12S 

BO 

•far 

9F 

1 - 16 

129 - 154 

81 

- 

sr 

IMA - 1 U2 

155 

SB 



1 ! [ 

156 

sc 



1 !\ 

1ST 

9D 



IM 

150 

9E 



1 r 

139 

3F 



i! L 

160 

AO 



|!SPACE/ 

161 - 254 

Al 

Jfa 

FE 

\U ~ 1!- 

235 

FF 



\m 


TTie ASCII codes between 33 iirut lib are just Hie normal character set, including digit* 
and upper and lowercase JetCcra Ttwy *f* repated belween 1*1 and 234, prefixed by 11. 
The exceptions are Hie broken bat 1 symbol l, which I* rocltd a* I I, and the quote mark " 
which bs r. Finally, SPACE fnuii be encoded as 1 SPACE, but only when it occurs at ihe 
siart of a line, Thk coding sometimes cal Led CSREAD fonralr Is the aame as that used 
In function key definition*. 


Figure 133, Control characters and GSRELAD coded equivalents. 

Then decode cart be used on the text file to produce the final exec file, 
which might be called 'NLQf, 

•EXEC NLQ 

will then switch the printer into NLQ mode. Because of the limitations 
of most oi these types of printer, the NLQ exec file should not be used 
with either CONDEN5 or POUND. One exception is the Citizen 12DD 
printer, which allows condensed Nlq printing. Therefore the CQNPFN5 
and NLQ exec files can be used together. 
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There are four points to note about constructing new exec files. The 
printer must be switched on and off with 1 3 (ascii code 25 and ! C (ASCII 
code 3). Codes which are sent with the printer oft, have no effect 
whatsoever, AIJ other control characters should be prefaced with IA so 
they are sent only to the printer. A RETURN character must be explicitly 
coded as l M became DECODE ignores the ends of lines in the original 
text file. Finally, notice that the test near the end of figures 13 A and 
13.2 starts with + I f; when decoded this becomes * I f which is the 
operating system's equivalent of a heM (reminder line). By using this 
technique, normal text can be incorporated Into I he exec file without 
any danger of it being accepted as a command The texl is useful 
because it serves as a reminder that the exec file has been used- 

Setting a Page Layout 

When you print a spreadsheet direct from ViewSheet, there is no way of 
selling a left margin, The sheet is usually printed flush against the left- 
hand edge of the paper. To prevent this, the paper has to fee put into the 
printer so that it starts printing further across the sheet, or the model 
can be spooled using IheVS&FEU program explained in Chapter 1 Six, and 
read into VIEW, where all the usual page layout options an? available. 

But many printers are intelligent enough to do the simple margin 
setting job themselves. On an Epson-compatible printer, the control 
code F-5C’ r n set a left margin, of n character spaces Therefore to set a 
ID character left margin the printer must be sent FSCT 10. Note that 
this is in terms of characters, so if the printer is in condensed mode at 
the moment of sellings tlien the margin will naturally be narrower. 

Similarly, ViewSheet does not divide the spreadsheet Into pages. If the 
total number of lines in the printer windows exceeds the length of the 
paper in use, then printing continues inconveniently right across the 
page break. Again most printers are clever enough to deal with this 
themselves. ESC" C" n can be used to tell the printer how long the paper 
sheets are, and ESC n to set a gap of n lines between the bottom line 
of one page and the first line of the next. These features are often called 
set form length 1 and 'set perforation skip 1 in ihe printer's manual 
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So to set up a page format for A4 paper, with 70 lines per page, and one- 
inch (six-line) margins at left, top and bottom, set the paper in the 
printer at the place where the first line on the first page should be,, and 
set the control codes: 

ESC **C" TO 
ESC 12 

ESC "1" TO 

This translates into CSRE AD coded form For DECODE as: 

FAJEIACIAF 
«A| l t AN F AI L 
■ A1 ] fMIJIJ 

To ensure that the printer is not in condensed mode before the left 
margin is set, the printer should be reset This restores the printer to its 
default state, and is a more elegant way that switching off then on 
again. The codes for this are £SC rr @", or: 

i ai riAB 

All of these codes are combined in the text file in listing 2 at the end of 
the chapter. It is intended to define a good layout for A4 continuous 
stationery- The exec file, once decoded, does the following; 

Resets the printer to its switch-on state 

Sets a page length of 70 lines 

Sets a twevinch perforation skip 

Sets a one-inch left margin 

Defines the pound sign like the pound program 

Sets condensed print mode 

This layout allows about 115 characters across the page, rather than the 
normal 132 for condensed mode printing, because of the width taken up 
by the margins. However, only about 100 should be used to maintain a 
decent right margin and keep a balanced look to the pages. 
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Type in the text file, and save it a name like 'Airsrc is suitable. Then 
use DECODE to produce the exec file containing the control codes: call that 
'A'lP', Now whenever some printing must be done (without a printer 
driver), just set the paper in the printer to where the first Sine should 
appear, and type; 

* EXEC A lP 

and die printer will be instructed to set the page layout as described. 

The use of the A4P file is not confined to ViewSheet, basic listings can be 
printed out using this method, so they don't print over the perforations 
m the paper. 

Using the intelligence built into the printer in this way is fine, but should 
not be mixed with the use of a printer driver. View and ViewStore 
generally rely on having total control of the printer; they keep a count of 
the lines printed, and print blank lines to give margins at the head and 
foot of a page. They use spaces to maintain a left margin. 

Changing Colour in !BOOT Files 

If DECODE is used, art-auto-exec file such as !BOcrr can contain the control 
codes necessary to change the screen colours. The relevant keypresses 
are described m Chapter Five, These can be incorporated into a text file 
using, for example: 

MODE q|M 

ISIDMlQrOlO 

ismeioioio 

for light blue (cyan) text on a blue background. The text file can then be 
decoded to produce the [boot file. 

The place in the ’BOOT file to use these colour commands needs some 
thought- Obviously, they must be placed after any MODE command as 
above, because changing mode always resets the Ween to its normal 
colours, B-u-t loading a set of window definitions j n t 0 ViewSheet can 
also cause the mode to be changed, so the colour commands need to be 
placed after any LW too. 
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A Final Twist to Printing 


What happens when the spreadsheet grows to more than the width of 
the printer, even in condensed mode? The maximum 136 character 
width at most printers is little more than half the full width of a 
ViewSheet model. The maximum overall width of the printer windows 
can be up to 255 characters. If there is a need Lo print out this full width, 
then there is only one course of action: print the sheet side way si 

The sideprt program in listing 3 at the end of the chapter can be used to 
print even the largest model, in sections, down the length of many 
sheets of continuous stationery. U is compatible with most dot-matrix 
printers which have a graphics printing capability. More specifically 
those that support esc "L” double density bit image graphics and use 
esc "A" to set the line-feed sparing The most common exception is the 
Olivetti JP101 spark jet printer. 


This program 1$ a rewritten version of an original program by John 
Knight, published in Arum User magazine, in April 1987, 


SIDEPRT in Use 


ThesiDEEKT program does not print the spreadsheet directly; it can only 
print the contents of an ASCII file. So to print out any model it has lo be 
spooled to a hie first This can most easily be done using the ASO file 
spooler described in Chapter Six. Once there is a version of the model 
in an ASCII text file on cassette or disc, ihen sidefkt can be used to print 
that file. 

Type in the basic: program, and save it using a name such as SIDEPRT . 
This is a BASIC program, and so can't be us^J from within ViewSheet. 
Start up BASIC in the normal way, and type in; 

CHAIN "SIDfcfcftT 1 * 

The program first asks for the filename of the spooled tile to he printed 
out Type this filename in, and press RETURN. 

SSDEPHT reads in the first section of the file, displaying dots on the screen 
to confirm its progress. The text is then prints! nut sideways. Up to 58 
lines of text are printed across the paper. The program can cope with 
the longest lines I hat can he generated by ViewSheeL up to 255 
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character, If the file contain# more than 38 lines, then the remaining 
text is read in after the first is printed, and this way a Rleof any size can 
be printed. 

The program may be stopped by pressing ESCAPE at any time. The text 
tile will tie safely dosed. 

Inside SIDEPRT 

If the printer Is set to give automatic line-feed, then Stdeprt double¬ 
spares all the characters along the lines of test. This can be prevented, 
and the normal spacing restored* by changing line SO to. 

00 crlf$ = CHRS L3 

In order to print each character of the file sideways, foe STPEFRT 
program uses the definition of the character held in the micro and 
doesn't rely on the printer's character set. It reads this definition at the 
beginning of the assembler routine. This means that all characters, 
including pound and any special ones redefined using VDU 23, will be 
printed out just as they are shown on the screen The characters are 
printed using the double-density bit-image graphics mode of the Epson- 
compatible printer. 

The program can be modified for incompatible printers, providing they 
have some graphics printing capability. All the printer control codes 
used are defined at the start of the program. The codes in 'resets' are 
used to reset the printer to its switch-on state, 'crlfS' sends the print 
head back to the extreme left and advances the paper one line. 'formST 
feeds the paper to the top of the next sheet. The distance the paper 
moves up for each Une is set by 'pifechS': the idea is to set the line pitch so 
that the characters along each line of text (reading sideways) are not 
too Widely spaced. The last printer control string is used to pul the 
printer into a bit-image graphics mode; the actual codes sent are ESCL. - 
m n, where m and n form the number of graphics dots to be printed. The 
constant 'dotg%' Ls the maxi mum number of dots for that graphics 
mode. If 'dots% r is wildly different from %0, then the printed 
characters may look tall and spindly, or alternatively squat and wide, 
but in practice a wide variation is acceptable to the eye. 
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It should be noted that siphfrt can print any test sideways It isrii 
limited tes spooled ViewSheet models; any text file can be printed out, 
providing the line length doesn't exceed 255 characters. 

Printing the Cell Contents 

The ViewSheet FnsNT command prints out the value or label in each celJ 
that is visible in an active printer window. The formulae in the cells are 
not printed out only the values of the formulae. ViewSheet hap a 
separate command to print out the contents of cells, including formulae. 

To print the cell contents for the entire sheet, type: 

f pc 

at the Command mode prompt. The type of output given is illustrated 
in figure 13-4, which relates to part of the BEACH pebble project model 
from Chapter Four Each line consists of the name of a cel! r followed by 
its contents. The contents include values (cell R14 for example), labels 
(cell D16) and, most importantly, the formulae (as in cell D14), Note 
that only occupied ceUs are listed, and the slots are printed out in the 
order in which they are calculated, starting at AI and going left to right 
along each row in turn. 

10.1 

El 3-AVERAGE[B&B14I 
013*2 
0.0 

E14-AVERAGE(B6B14J 
D14‘3 


mean 

AVERAGE 10 
variance 
AVERAGE(EGE14) 

Figure 13.4- The contents of some of the cells in the 'beach' model 

This type of listing of the cell contents can occasionally be very 
important in finding the mistakes in a model if things go wrong- For 
example, it makes it dear when a cell makes a forward reference. Of 
course, the bfach model contains several forward references; cell D13 


( 


( 5 


El 2 
El 3 
DU 
El 3 
B14 
314 
E14 
BIS 
BIS 
A16 
BIS 
01 & 
£1$ 
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refers to aV£RACE(B 6 R14), and cell Bl4 is forward, However, this isn't 
tm bad, because the range Bti B14 contains only values* not formulae. 

The PC command sends test via the printer driver, so the spooler 
programs ASCII or VSXFEU can be used to create VJEW-readable files if 
necessary. 

There is no screen: equivalent of the PC command. However, if the cell 
contents need only he shown nn screen, or if a printer is not connected, 
then the following has the equivalent effect: 

PRINTER 

«rx s o 
PC CTRL-N 

This ensures that any characters sent to the printer by the PC command 
are lost and not printed out. They are Shown on the screen as normal. 
Pressing CTflL-fM causes the screen to pause until SHIFT is pressed, after 
every screenful scrolls past. 

When real printing must be resumed, the normal parallel printer should 
be selected, and the printer driver reloaded in the usual way: 

*rx s i 

PRINTER FX* 

Serial: Serial printers require *FX 5 2, 

Net: Select the network printer with *FX 5 4 
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Program Listings 


Ip REM ExeC file processor DECODE 
20 REM to copy GSREAG format files 
30 REM for BBC B/5+7K/C/2F/& 

40 REM <Ci i960 Graham Bell 
50 ; 

60 osnewl = 4FFE7 
10 GsargS = ftFFDA 
00 osbqet - fiFPD7 
90 osbput ■ SfTPfl 
ICO CIS find = 4FFCE 
U0 gsread - SFFC5 
120 gsinit - *FFC2 
130 gept = IF2 
140 : 

150 ill MEM - fcZDOG 
160 code * G2DOO 
U 0 text In - * 2 F 0 D 

100 REM routine can be assembled at other suitable addresses 
190 REM eg code - iAGQ and text In = 4COO In stand alone SBC 
micro 

20D REM note in line 1570 suml <> 6^73* and delete line 150 
210 ; 

220 argptr - tA& 

230 : 

240 FOR It = 0 TO 4IFF 
2 50 mcode = 0 
260 NEXT 
270 : 

260 FOR pass ■ 0 TO 3 STEP 3 


2 90 Ft - 

code 


30Q ( 

OFT 

pass 

310 

LDA 

11 

320 

LDX 

iarqptr 

330 

WV 

to 

340 

J5R 

esatgs 

350 

LDA 

argptr 

3 6P 

5TA 

g?pt 

310 

LDA 

argptr *- 1 

300 

£TA 

gspt + 1 

390 ; 



400 

cue 


410 

JSR 

gsifl.lt 

420 

BED 

acgerl 

430 

LDX 

10 

440 

JSR 

cpynam 

450 ; 



4 60 

5TX 

filtwo 

470 i 



400 

CLC 
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4SQ 

JS* 

asinit 


500 

BEG 

srgerZ 


510 

JSR 

tpynaffl 


550 

: 



530 

LDA 

*64 


540 

LDX 

*£iinaffi MOD 256 

550 

LD¥ 

tfilnaiE DIV 256 

560 

JSK 

oaf Indl 


5^0 

AND 

*255 


5fi0 

BEO 

filer1 


550 

STA 

Ipfilo 


600 

* 

f 



610 

TXA 



020 

CLC 



€30 

ADC 

f 1.1 two 


S4 0 

TAX 



650 

BCC 

open! 


€60 

TNY 



670 

.Op^nl LDA 

#64 


6BQ 

JBFL 

□ g f i n d 


€30 

AMD 

1255 


TOO 

BEG 

openfl 


710 

ETA 

hpfile 


720 

JSR 

close 


730 

« 

■* 



740 

.filer2 BRK 



750 

OPT 

FNeqilb 

(131) 

760 

OPT 

FKeqiU 

("Output £S4^ exeats") 

770 

. argerl BKK 



7&a 

OFT 

FNequb 

(128) 

730 

OPT 

FMequS 

("No arguments 11 .! 

BOO 

. arger2 BfiJS 



610 

OPT 

FNequb 

am 

B2Q 

OPT 

FNeqU3 

C*bo output fll^l 

&30 

. f iled brk 



040 

OPT 

FNequh 

(130) 

0 50 

OPT 

FNeqUB 

rInput file net found 4 *) 

0 60 

.£ilor3 BRff 



070 

OPT 

FNequh 

am 

BOO 

OPT 

FNeqUB 

( M Cfln*t open output file*) 

0 30 




300 

* 

- 



310 

► opimfl L.PA 

*126 


020 

JER 

esfind 


330 

AND 

*255 


340 

BEQ 

fUer3 


350 

STA 

apl'iie 


360 

■4 



970 

* get In LDX 

#0 


9 SO 

LEY 

ipfilfl 


900 

,getIn] JSR 

osbget 


1000 

BCC 

■getJnZ 


1010 

LDA 

113 
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1020 

.getln2 

RQR 

1030 


sta 

1040 


IHX 

1050 


CMP 

1060 


&N£ 

1010 

a 

» 


1080 


LDA 

1090 


SYA 

1100 


LDA 

1110 


STA 

1120 


LDY 

1130 


SEC 

1140 


JSR 

USD 



ueo 

, p ut In 

JSR 

1110 


STY 

11 BO 


LDY 

1190 


BCS 

1200 


JSR 

1210 


LOY 

1220 


BNE 

1230 

: 


1240 

.put InJ 

BIT 

1250 


Bt?L 

1260 

m 

¥ 


1270 

+ cldSe 

LEA 

32B0 


LDY 

1290 


JSR 

1300 


LOY 

mo 


JSR 

1320 


_TMF 

1330 

■ 

« 


1340 

.gpynam 

JSR 

1350 


BCC 

1360 


LEA 

1370 

.cpyl 

STA 

1380 


rux 

1390 


BCC 

1400 


RTS 

1410 

* 

* 


142Q 

r en flng OPT 

1430 

. eiitwo 

OPT 

1440 

.ipfile opt 

1450 

.opfile OPT 

1460 

. temp 

OPT 

1410 

: 


148 0 

* filnam 


1490 



1500 



1510 

NEXT 


1520 

* 


1530 

suitA = 

0 

1540 

FOB 11 

= 0 


eoflag 

tejttJjip K 

113 

getlnl 

I text In MOD Z56 

Itejctlri DIV 256 
gspt + 1 
#0 

gsinit 

g s rest* 

temp 

gpfile 

put In1 

eabput 

temp 

put In 

ipflag 

get In 

10 

ipfii* 
gafind 
gpftie 
oafind 
osnawl 

ggread 


f ilnam., X 
cpyniim 


Etteqab (01' 
FtJequb (Q) 
ftJequb (0> 
FNequb i D l 
nfequb <PJ 


to tirr 
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1550 sufiil = sumt + IV’cnde 
15GO NEXT 

1510 IF suml <> 479F6 THEN PRINT "Assembler error - please 
check listing": END 
156Q ? 

1590 PROCdficll C“SAVE DECODE * + 3TR$-d*de + " +200™ I 
STRING* [2, >* - * STRS - C6FFFTOOQO OR code) M 
IfiOO END 
1610 : 

1 €20 : 

1630 t 

1640 FNegub Ebytelj 
1650 7FI = byts* 

1660 P% = PI * 1 
1670 =* pass 
1660 : 

1650 DEF F^^us [String*] 

1700 $FI - string* 

1710 PI - PI * LEN String* 

17^0 ■= pass 
1730 : 

17-JO D£f pftOCoacll (atring*l 
5 750 LOCAL X%j Y% 

1760 DIM X* IFF 
1770 5fl - XI DIV 256 

17 so sx% ■ string* 

1700 CALL 4FFF^ 

1600 EHDFROC 


Listing 13.1. CEREAD format filedeccder 


IB 

I A | [ J A0 
I A I [IAC3AF 
I A I M AN f A J L 
3 A|J|A 11 A -J 
iA | [ lAfttA| | 
f A | i |Ai IAIPIAI 0 IAF 9 
IA | [ | AI | A | AIA | i 
IAI [ I AS IA11? ( AE | A£ 

I AT S I JlAFRIAIf lA-FAl l ISIAIR 
IA| T I i IA | R | A | ! lilABTAieiAH 
1*10 
«c 

* I I A4 page layout 

*11 (CJ 19 BS Graham B*li|M 

Listing 13.2 Coded exec file to set up A4 page layout. 
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10 ft£34 SIDEPRT sideways printer 
20 p -£H for Viewsher-t spreadsheet s' 

3D REM for BBC B/B4/H/C/E 
REM £C) 198 9 Graham Bell 
50 : 

gQ REM printer cbntroJ string? 

70 reflets - CHH$ 27 + "8" 
fiD crlfS * CHUB 13 + CKR$ 10 
30 formS = CHE$ 12 
100 pitcbS = CHR$ ?7 ■ *A" * CHRS 3 
U0 graphics? = CHR$ 27 * “L* 

120 dots* * ^60 
130 i 

140 ON ERROR FRQCercer <0j 
150 PRINT "SH>EPRT rt 
160 : 

170 file! = nfopen fFMname (“Spool *R H k 

100 : 

190 MOPE 7 

200 hulk lines* - dots*/20 
210 HIM buffer* 255 * maxitnesl 
220 PJM start* (9iftiaines*k 
230 matrltf* - Ffiassembie 
240 : 

250 P pEQQprinter (reaetSj 
2 60 PftOCprinter (pitflfrSj 
270 REPEAT 

200 lines* = FNread_Lines (marlines*,file*k 

290 chars* - FNmflX length UtneflIJ 

500 dotsS - cm$ (Times* * 20) MOD 2501 * CHRS ((lines* p 2U3 
Div 256) 

31D FGR chftr% ^ 0 TO chars* - 1 
320 PROCprinter (graphics's + dutsSk 
330 FOP- line* -= lines* - 1 TO 0 STEP -1 
34D A* = FNgeL_chei (Unfit, chArl) 

350 CALL aatFllt* 

360 NEXT 

370 PROCprlnter fcrlfSl 
330 NEXT 

390 PftOQprtnter <f™$> 

4Q0 UNTIL SOFT file* 

4i□ close# rile* 

420 pR£>Cprinter (reset5) 

430 ENP 
44D : 

450 i 
460 : 

47D DEF Ffiread lines imaxlinesl, rile*] 

400 LOCAL line*. ptrS, byte* 

4 00 FOR line* = 0 TO tr^xlineal 
50C start*(line*j = 0 
510 NEXT 
520 line* = 0 
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530 ptr! - 0 
540 REPEAT 

550 byte! = BGET# filel 

560 (byteI - 6OP] OR (byte! > iiFS THEM boff*r*?ptrl - 
byte! ; ptrl =■ ptr! * 1 

510 IF byte! = &0D THEN line! = line! * l : starts (Um%> = 
ptrl ; PRINT 

500 umIt Clinel - maxLlnes%> or [EOF* file*) 

590 IF PGS <> 0 THEN PRINT 
000 = line* 

61G I 

620 DRF FNmax_length (mutH naal) 

630 LOCAL line!, length!, maul 
640 max! 3 0 

€50 FOR line! - 0 TO ma xlines I - 1 

660 Length! - start! (line! * 1) - start! (line!) - 1 
670 IF length! > Inan! THEN max! - length! 

63D NEXT 
690 - max! 

100 ; 

HO DEF FNget_char (line!, char!) 

120 LF icharl >» (fitart!Clinel * 11 - start!(line!) - in THEN 
= 32 ELSE = buffer!?(startl(line!) + charl) 

730 £ 

740 DEF FNasaemble 

750 DIM addr 60, block 0 

760 OSWurd = iFFFl 

770 DBwrch - fiFFEE 

780 FOR pass - 0 TO 2 STEP 2 

790 FI = addr 


800 i 

DPT 

pas*r 

810 

5TA 

block 

820 

I2JA 

12 

830 

JSR 

bawrch 

B40 

LDA 

#10 

050 

Lt>X 

Iblcrck. mod . 

860 

LDY 

# block DIV . 

870 

JSR 

□sword 

eao £ 



SOD 

LQX 

#7 

900 .loop! 

LDA 

blddk + i,X 

010 

JSR 

print 

920 

JSR 

print 

930 

DEX 


940 

BPL 

ldnpL 

950 

LDX 

fl 

960 

LDA 

#0 

970 ,1 QQp2 

■IS R 

print 

900 

DEX 


900 

BPL 

1 □ Dpi’ 

1D0Q ; 



1010 

LDA 

#3 

1020 

JMP 

dSwrch 
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3 030 5 


1040 .print 


fBA 
LDA #1 
J 5 R oswrch 
FLA 

W oswrch 


1050 

lOfiO 

1070 

igsg 


1090 .end BRK 
11 DO } 

11.10 NEXT pass 

II 2D IF end-addr THEN PAOCerrbr(2) 

1130 -add* 

1140 : 

U50 REM Wafite string to printer flftiy 
:IGG b£f PRQCprlnter (string*) 

1170 LOCAL chart 

1LS0 VLLF 2 

U90 FOR chart = 1 TO LEN strings 
1200 vnu 1, ASC tHID$ (et tingS, chart)) 

1210 NEXT 
1220 VDU 3 
1230 EJfDFROC 
1240 z 

1250 GET FNname (p$J 

1260 LOCAL n5 

1270 PRINT 1 pfj 

12BQ INPUT "? " nS 

1290 Rm delete trailing spaces 

1300 REPEAT 

1310 IF RIGHT${n$, 1) - 41 " THEN nS = LEFTStrt*. LEN H$ - i) 
1320 UNTIL RIGHT*Cn$* 1) O N “ 

1330 - nS 
1340 ! 

13S0 DEF FNopen mS> cS ) 

L300 LOCAL h% 

1370 cS - LEFTS tcS, 1) 

1380 PRINT “Opening M ; n$ 

1390 IF C$ = THEN hi = CFENIN fi$ 

14Q0 IF c* = -13- THEN hi - OPE HUP n* 

1410 IF c$ - THEN hi = QFENOtJT n$ 

1420 IF hi - Q THEN pikXZerroi il) 

1430 = h% 

1440 ; 

1450 PEF PRDCerror rnumber11 
1460 CLOSE10 

1470 IF number* - 0 THEN REPORT PRINT 

14 30 IF number I = 1 THEN PRINT “Can't find file- 

1490 IF numberI = 2 THEN PRINT "Assembler error- 

1500 Efim 


Listing 3* Prints ASClt files sideways. 
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Functions 


ROW and COL 



The HOW and OOJ. functions, introduced in Chapter Three,, are often 
used simply to turn die location of a formula into a number. The 
multiplication table example given in Chapter Three uses this property, 
but there is another important application of these two functions. 


Commonly, a spreadsheet is used to maintain a list of information, a 
sort of primitive database. Additional items can be added to the list by 
inserting whole rows or columns of cells* An example of this approach 
is the household budget model 'HOUSE' developed in Chapter Four, with 
the list of household expenses. But how can the number of items in the 
list be found? The initial number in this model was five items, but more 
could be added. Because inserting a row or column adjusts all the 
formulae intelligently,, functions like average and MIN 1 continue to work 
properly, but if the size of the list is needed for any other calculation, 
then this must be found in another way. 


The answer is given by ROW. Obviously, Lf ROW were used at the head 
and foot of the list, then the length of the list fs the difference between 
the two. One possible layout is shown in figure 14.1. The cells A3 and 
Ay both contain the formula HOW, and the length of the list (seven 
items) can be found at any time by using A9 * A3 + 1 as in cell CM. 
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Figure 14.1 Finding the length of a list. 
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This technique could aIso he useful in finding the number of pebbles in 
the list on the Pebble Project model from Chapter Four. 

Conditional Functions 

There are three special spreadsheet functions supported by ViewShcet 
that may he described as conditional, The first and most familiar to 
most people is the IF function, the other two are CHOOSE imd LOOKUP- 

IF Only... 

The if function is used to select one of two possible outcomes. In 
English, you might say: 

IF the egg floats THEN it's bad OTHERWISE it's fresh 

The selected ou tcome depends on whether the condition, 'the egg 
floats' r is true or false. ViewSheet has a very similar structure: 

IF (<conditian>, <outCGifte-2>] 

tf the condition is true, then outcome! is selected. So the following 
formula has the value 10 when AI is greater than A2, or 0 otherwise: 

( IF fAl > A2. 10, Qj 

The if functions can also be nested, so that for example outcome-1 
could then select between two further sub-outcomes. This nesting is 
important because ViewS heel has no AND or OK operators like esa$!C:_ 
Conditions cannot be combined. Consider the following formula: 

i IF Icqnd-lf IF jeond-2, 10 , 201, IF |ccmd-2 r 20, 30) ] 

This can be used to test for any combination of conditions one and two 
If both are true (this equates with AND), then the value of the formula is 
10; if either one or the other are true then the value is 20, and if both are 
false, then the formula value is 30. 

Frequency T ables 

An interesting use of the IF function is in the building of frequency 
distributions As an example, the Pebble Project model beach can be 
used. Ln this, a list of beach pebble si 2 es is given. The objective is to 

t 


( 
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divide them into groups or desses, and show how many are between six 
and eight centimetres long, how many between eight and 10 „ and. so on. 
This is a frequency table; it shows the number of pebbles in each size 
group. The frequency distribution shows how the number in each group 
varies. Some groups are large (there might be 15 pebbles between six 
and eight centimetres in the sample), others are very small (only two 
pebbles between 16 and 18 cm) 

Figure 14.2 shows the BEACH model loaded in, with the display divided 
into two windows (note the gap between C and G along the top 
border). The first window shows cells B 1 to C16 as they were originally. 
The new window shows the area G 1 J16; this will become an occurrence 
table, from which the frequency distribution can be derived. 
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Figure 14-2- Setting up an occurrence table for the pebble data. 

The information in rows two and four of the occurrence table are to be 
used as the lower and upper limits of each frequency class. They are no! 
labels, but are put in the torm shown so that the limits (six in cell G2 for 
example) can be referred to in other formulae. The first four formulae 
are shown in row six of the table. 


The formula in cell G 6 as constructed so that it gives the value one only 
if the pebble length in cell B 6 is both greater than Ihc class minimum and 
less than the class maximum, otherwise the value should be zero: 


if tBG >- G2 t IF * Gfl, I, 0} , 0) 


) 
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This is equi valent to a 'tick 1 ' in the box if the pebble belongs to the group 
represented by that column. 

The formula can be repeated across the whole of the occurrence table, 
taking care over the absolute and relative references. As a check, the 
formula in cell J14 should be; 

IF (B14 >= J2 # IF (B14 < Jfl H l* 01, 0) 

Notice that the >= conditional operator is used for the lower limit, < for 
the upper limit This is to avoid problems when a pebble length value 
lies exactly on the boundary between two classes. By arranging the 
conditional operators like this, each value can satisfy the conditions for 
only one class. 

When the table is complete, there should be only a single non-zero value 
in each of the rows, marking the class within which the pebble length 
falls (that is, one tick per pebble}- Each of the das® columns can be 
totalled to show the number of pebbles from the sample in each class 
(the number of ticks for each group). Figure 143 shows the model with 
the occurrence table completed, with the frequencies in each class 
totalled in row 16, 
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Figure 143. Frequency distribution barchart for the BEACH model* 
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To construct tables like these, a short-cut can be used in ViewSheet. 
Each cell can be filled with a formula meaning (length >= minimum) # 
(value < maximum). This works because a false condition has the 
numerical value zero, a true condition the value one. The formula 
multiplies the twq conditions together, and only if they are both true is 
the overall formula value one. However, this approach is less likely to 
work with other spreadsheets, which often assign different numerical 
values to (rue and false. 

Charting Success 

Figure 14-3 also shows a new third window and its definition. The new 
window shows a histogram or bar chart of the frequency distribution of 
pebble lengths. All the values in any window can be displayed as a bar 
chart merely by placing C in the Opt part of the window definition. The 
bars are rows of asterisks, the length of the row controlled by the value 
in the cell. Negative values are shown by rows of exclamation marks. 
Printer windows can be converted to bar charts in the same way. 

Unfortunately, all bar charts drawn this way have to be horizontal, 
because each bar is printed within a single cell. To make proper graphs, 
View Plot or ViewChart must be used. 

To build the bar chart in figure 14.3, the cells C27 to C30 each refer to 
one of the column totals in row 16. So the formula in cell C29 is simply 
116, and the value of the formula is five, so the bar Is five asterisks long, 

It is always worth checking that the column width of the chart window 
is large enough for the bars to be shown in full. With more pebble 
measurements than are used in the example, the number in a single 
class might exceed nine. If a value exceeds the width of the column, the 
bar is truncated. The maximum value that can be displayed properly is 
equal to the column width. Normally the cure is to increase the column 
width iso all of the bar can be displayed. 

If I he column width can'l be inci eased, then the scab of the chart can be 
reduced. Normally, the scale is one to one: a value of five means five 
asterisks. But the cell can have a scale factor, so cel] C27 above could 
contain the formula 116 * 0,5. This would half the scale. Alternatively, 
116 * 2 could be used to increa^ the scale. 

AU the values for a whole window are convert ed to bars. For I his 
reason, charts are normally allocated a window of their own. Figure 
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143 also shows that a bar chart window may contain labels a& normal; 
they are not affected. 

After construction of a bar chart like this, the window definitions should 
he saved with the SW command. There should then be two separate sets 
of window definitions for the same model; each could be loaded to study 
the data in a different way, one giving a statistical perspective, the 
other a graphical view of the same data. 

Choosing Between Possible Values 

The second conditional function Ls choose. This can be used to select 
one numerical item from a list. The general form of the syntax is 
CHOOSE The list is a series of values separated by 

commas, so the function below: 

choose a t 10, % a, i t at 

has the value 8 f since 8 is the third item out of five in the list. 

The Ust of values may include ordinary numbers, cell references, other 
functions and ranges. If a range is used, then it has the effect of 
including the sum'of the cells in the range as a single item in the list. 
Therefore the following: 

CHOOSE <3, 10* Cl Cll f C13H 

gives the value of whatever is in cell Cl3, and not the value of cell C8 as 
might be ex peeled - 

This may not seem all that useful: why not just have a cell reference to 
Cl3? CHOQ&E is used mainly because the item lo be selected can itself 
depend on another calculation. This function returns the number of 
drtvs in a month selected by the value in cel] A3: 

CHOOSH (A3,.31,2e,31,30,31.30,31,31, 30* 31,30,313 

So if cell A3 contains four, the CHOOSE formula gives the number of days 
in April, the fourth month. 

Because CHOOSE can't choose item number 4 S from the list, so the item 
number in cell A3 in the above example must be a positive whole 
number. If a negative number or zero is used, then 7Error' is displayed 
In the choose formula slot. If a real number is used, I hen this is 
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truncated; 4,8 selects the fourth list item, 0,5 selects the zero item and so 
gives an error. 

Go and Look it Up! 

The third ViewSheet conditional function is lookup. The syntax is: 

LOOKUP <<value> r <conparo-rBngcr> # <resuit‘range>J 

This function is generally used to look up a value in a table. It can 
sometimes be used in the same way as choose. For example if a table 
were set up like that in figure 14.4, then the formula lookup (A3, A10 
A21, BIO B21) would give the number of days in the month according to 
the value in cell A3. LOOKUP works by comparing the value (tn cell A3) 
with each of the values in the first range A10 A21 When it finds one that 
is the Same as A3, then it returns the corresponding value in the second 
range BIO U21. 
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Figure 14 4 Length of each month in days. 

but lookup is different from choose; if A3 in the above examples 
contains the value 4.8, CHOOSE returns the number of days in April, but 
LOOKUP gives an error because no Cell in the LOOKUP range contains 4.8, 

It ha$ to be an exact match for LOOKUP to work. 

LOOKUP is usually used for processes like finding prices in price lists. If 
each type of item has a unique code number (tike bar codes on 
supermarket goods), then a price list can be set up. It should contain the 
product code numbers in the LCxlKUP range and the corresponding prices 
in the result range. 
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Conditional Weaknesses 

The major problem with aU the conditional functions is that they cannot 
deal with labels at all So with the price List example, the product codes 
may not contain any letters or they witl be treated as labels. The coding 
system used in Habitat shop (whereby 718300 is a rolling pin) is 
acceptable, hut the Acorn item code system (SBB07 is a ViewSheet fom) 
is not, 

Many other spreadsheets (though not on the BSC micros have a lookup 
function that acts more intelligently, so an exact match is unnecessary. 

If the LOOKUP range is in order (lowest number first), then LOOKUP finds 
the largest number in the LOOKUP range that is not greater than the 
value given. For example, this method can be used to find the top (or 
marginal) rate of income tax paid according to a person's salary. In this 
case the LOOKUP range contains the thresholds at which the tax rate 
changes: the point where basic rate tax is paid for the first time and the 
points where enhanced rates start. The result range of course contains 
the percentage rates themselves. 

Trigonometry and Logarithms 

ViewSheet provides a range of the normal trigonometric functions; 

SIN (a), co$ (a) and TAN (a) and their inverses ASN (n), ACS fn> and 
a in (n). 

These trigonometric functions expect the angle a in radians, or return 
the angle related to the value n in radians. One radian is about 57 
degrees, but the following two functions can be used to convert easily 
from degrees to radians and back again. 

convert angle from degrees to radians rad (at 
convert back from radians to degrees deg (ai 

So if a is an angle in degrees, its cosine is given by the formula 
COS (HAD (a)J; first convert a to radians, then take the cosine. 

Conversely, to convert a tangent n to an angle in degrees, use 
PEG (ATN (n)3; take the arctangent and then convert to degrees 

Another useful function is PL the value of it This requires no brackets, 
as it has no argument. It always gives the value 3.141592653. 
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IN (n) is the natural (base e) logarithm of n The natural anti'logarithm 
is given by exp (n). (n) is the {base 10) logarithm of n. There is no 

explicit anti‘logarithm function, but the formula 10 A n can be used 
instead. 

To complete the list of ViewSheet functions* AtiS (n) is the magnitude, or 
absolute size, of the argument n, Atl& ignores the minus sign if n is 
negative, SO: 

AB5 £-5.11 = 5.1 
ms (7,51 = 1*5 

TNT fn) strips off the fractional part of a number and leaves only the 
whole number, so that 

itrr {-5,13 - -5 
SHT {7.51 - 1 

For negative numbers, this is different from the BASIC version of 3NT, 
which returns the next lower integer. In BASfC: 

INT l?.5j = 7 

XHT {-5,13 = -6 

5GN' (n) gives one of three values, 1 if n is a positive number, 0 if n itself 
is 0, or -1 if n is negative Thus SGN {-5,1) = -l and SGN (73) - L 

5QH tn) is the square root of n: n must be positive, or an error will occur. 
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ViewSheet has a special facility for linking several spreadsheet models 
together. Final figures in one model may be needed to form part of a 
second model and at other tunes, the figures from several models may 
need to be collated together in an overall spreadsheet. These figures 
can be transferred automatically from one model to another. 


The method does not work with the Cassette Filing System, because it 
makes use of random-access files, but is fully compatible with the DPS, 
ADF5 or the Econet network. 


The general procedure is as follows. First, create a file on a disc to hold 
the figures to be transferred. Then on the first model P write the figures 
into the file. Now the second model can read the figures directly from 
the file instead of copying them across by hand. The special files are 
called frii.*: files, or array files. 


Creating a Link File 

The ViewSheet command to create a special file for this purpose is: 

CREATE -<nuii±ier> <nmx-'-y> 

where <nitmber> controls the name of the link file. The files must 
always be called V vs<number>^ so if <numbor> is one, the file is 
called V VST. <number> can be up to 235. 

The sl£c of the link file is controlled by <max-*> and <max-y>, The file 
is arranged in rows and columns, but these needn't be the same as the 
rows and columns in the original spreadsheet, is the number 

of columns in the array, and <max-y> is the number of rows. So (<max- 
x>, <max-y=0 are the co-ordinates of the bottom right-hand cell in the 
array. 
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Before creatine a link fib in this way, the arrangement of values within 
the array should he worked nut, 50 that the file is no bigger than 
necessary. Each cell within the array is known by its (x, y) co-ordinates. 
The arrangement of cells within a four by five link file is as below: 
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Each value to be transferred should be allocated to a certain cell within 
the file. Once this is done, the maximum fx, y) co-ordinates can be used 
in the CREATE command, Perhaps a four by five link file could be used to 
transfer the sales totals of five departments, for the four quarters of the 
financial yean 

To create a file with maximum co-ordinates H, 5} as shown, 20 cells in a 
four by five array, type in; 

CREATE 145 

at the Command mode prompt. The disc drive whirrs and a fink file 
called V VST is created, with room in it for 20 values, 

ADFS, Net The directory V must be created beforehond^sing the *CDHl 
Command. 

Writing and Reading Link Files 

ViewSheet ha$ a special fraction to write to a link file For example* to 
put the value 50 into the file V.VS1 , at position (4, 2) in the array; 

WRITE Cl# 4* 50* 

This is a function; if has to be put into a cell on the sheet The value 
displayed in the slot is the value written to the file. In fact, it is usual to 
write the value nf another cell or function into the file, rather than a 
number like 50, but any cell reference, formulae or value can be written. 
Remember, however, that the fink file may only contain numbers, it Is 
the value of a formula that is written, not the formula itself For this 
reason. Labels can't be used in link files either, 
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Reading a value buck From a link File is accomplished in a similar 
manner. The READ function is used - so to read the value written above 
into a cell, use: 

READ il, *>* 2i 

Viewheet can read a value before it has been written, because the 
create command automaticslly fills the link file with zeros. An 
unwritten value always reads as zero 

In both cases, reading and writing, the disc drive may be accessed while 
the spreadsheet is recalculating. With a small file, this is a very quick 
operation, but as the link file grows, the time taken for reading and 
writing the file becomes longer. If the time taken gets too long, switch 
the recalculation mode to manual by pressing SHIFT-fQ. An 'NT is 
displayed in the status area. In manual mode, recalculation of the 
whole sheet then takes place only when SHIPT-I7 is pressed, so the time 
taken is reduced to a minimum 

Link files with up to 41 entries (a four by 10 army for example) can be 
held in memory W the Disc Filing System, so reading from and writing 
to them is veryquick, Any newly written values are only stored 
permanently nn the disc when you press ESCAPE to leave the Sheet 
mode Since the link file is open while in Sheet mode, this means BREAK 
should not be pressed. 

Transferring Values Using a Link File 

The commonest use for a link file is to transfer values from one model to 
another. You might want to do this because the two models have 
developed separate] v, or perhaps because each is too large to be 
combined with the other in the available memory. 

As an example, let's consider the GADGET model from Chapter Four. 
This represents a manufacturing account for n ficticious small company. 
The final cell contains the overall cost of manufacturing items to sell. 
This cost is transferred to the trading accoun t which also contains t he 
costs of selling the items produced, and also to the ultimate profit and 
loss account. 
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The transfer between (he models can be done automatically by creating 
an array file to contain the values. Each model can read the relevant 
value from the file, where it was written by the previous model. The 
transfer only involves a single value between perhaps three models, but 
it is best to leave some spare space in the array file, in case the 
requirements of the model change, With the GADGET file, a 10-element 
array seems adequate. To create this file, with the name 'VVS2', use the 
following command: 

CREATE 252 

Load in the GADGET file, and switch to the Sheet mode. The final 
accounted cost to be transferred to the next spreadsheet is calculated in 
cell C37 The formula in C37 is the sum of C33 and C34. This can be 
replaced by the function; 

WHITE {2, Ip 1, C33 C34J 

The effect of this is that the final cost will be put in cell (1,1} of the array 
file V V52, Note that the sheet still displays the same number as before 
The displayed value of a cell containing a write function is the value 
that is written to the file, in this case the sum of C33 and C34, 

When the second model, the trading account, is constructed, it can read 
the value from the file al any time by putting the function; 

reap (2, 1* 1) 

in the relevant cell. 

Consolidation 

Another application of array files might loosely be called consolidation. 
This is the gathering together of results from several spreadsheets into 
one overall modal. To illustrate this let's look at the Pebble Project 
models In this classroom project, the variations in pebble size from a 
beach were investigated. When back in Ihe schou Samples from 
different parts of the beach, for example I he shingle zone, the gravel 
and sand, could be investigated by different groups of children. Once 
data has been collected and analysed for each zone of the beach singly, 
the variations between different parts of the beach could then he 
studied. 
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One way to do this would be to put all the data onto a single huge 
spreadsheet However, this is not the best method for two reasons. 

First, it prevents groups working separately on their own portions of 
the data Second, with a large amount of data, the UBC micro may run 
out of memory to store the increasingly large model. 

A good solution is to have each group working on a separate model. 
Each model can then be made to write its results into a link file. The link 
file can be read by an new model, which cart be used to analyse the 
overall picture, the way for each group to build a similar model was 
covered in Chapter Two, using a mnsfc file. 

The mask hie could be amended so that each model built puts its results 
into the link file. This can be done by making I he following changes to 
the basic BEACH model 

A1 GROUT* 

BIB WRITE 13, 1 r AVERAGE 06 0141 

E1S WRITE {3, Z r A2 r El? / B16 * 100} 

This uses a link file called 'V.V53'; the file should be created with the 
command: 

CREATE 3 A <grOup«> 

where <groups> is the number of separate sub-models. Thus the array 
has four dements for each group, Only two of these dements are used 
by the WfttTfc functions above, the first column for the mean and the 
second column for the coefficient of variation Each group should be 
given a unique number, to be put In cell A2 'Hie group number is used to 
control which row of the link file array is used by each group's model 

As each group loads the mask file and enters data into the model, the 
results are automatically written to the correct place in the link file. This 
works very well on a network, but you can do it just as well with a single 
classroom micro, with all the files being kept on a floppy disc. 

When each group has completed its work, and the data has been written 
into the link file, the data can be read into an overall model. This could 
show bar graphs of the average pebble length in each sample, together 
with the co-dfieient of variation. The graphs might well illustrate how 
the size decreases down the beach, from shingle to sand, while the co- 
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efficient remains nearly constant. This would mean that the pebbles and 
sand, though different sizes, are equally well sorted- 



Figure 15.1 Information flow through a Link file. 

One drawback of the link file is that it is only updated when a model is 
recalculated, If several models are Linked together, then a change made 
to Hie first file does not ripple through to the last model in the chain 
automatically- Each model 'downstream' in the information flow must 
be loaded and recalculated. A recalculation can be forced, however,, by 
pressing SHIFT-17. 

Writing to Link Files from BASIC 

The internal structure of a link file is compatible with BBc: basic data 
files, so information can he put into link files from other programs 
written in basec. 

The listing at the end of this chapter gives a set of procedures and 
functions to allow reading and writing of link files from basic. The 
function to open a link file must be used first, and this returns the file 
handle and the maximum co-ordinates of the link file, in a three byte 
array, at 'handled. PH uc write and FNfead work in the same way as 
their equivalents in Vifcw5heet f and use the data held at handled. 
Various errors can occur if the file specified is not a link file, or Lf the X 
and V co-ord inates exceed the size of the array in the file. Examples of 
how to use PROCopen, PROCwrite and FNrtari, as well as how to dose the 
link file after use are given in the listing. 
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A bask: program like this could be used to swap information between 
specially-written data gathering programs and ViewSheet models. 
Note that the BASIC program doesn't create the link Hie, this sdll has to 
he done by ViewSheet. With BASIC 3, replace OFENUP in line 430 with 
OPFNTSf. 


ViewStore and Link Files 

ViewStore has two methods of putting data into link files,, so that 
numerical material from a database can be transferred to ViewStore. 

The first is a special LINK utility. Run this like any other utility; load the 
dal abase, and making sure there is plenty of memory free, type: 

UTILITY LINK 

The usual 'Use select file?' prompt appears. With the LINK utility, a 
selection will almost certainly be necessary. One row of the link file is 
created for each record in the database, and the largest size a Hnk file 
can be is 255 rows. So make sure the database has fewer than 255 
records, or select carefully which records are to be used by the utility. 

The next set of prompts are for the names of the Helds to be put into the 
link file. As the link file can only contain number, these must be numeric 
fields. As usual, wildcards can be used in the fieldnames, and even the 
field numbers can be used instead. Pressing RETURN on its own ends the 
list of fields. Each field forms one column of the link file. The link file 
array might look like thisi 


tfl. 

tl) 

H2 t 

tl) 

EH r 

tl | 

CM, 

tl) 

(flp 

r2] 

K2, 

r2) 

(C3, 

r2) 

CM, 

*23 

ifi. 

r3) 


r3) 

(O, 

t3] 

(fL 

r3) 

(£1, 

r43 

I f 2. 

Ti) 

m t 

*43 

CM* 

r4) 

<fi. 

rS] 

i,t2 r 

*53 

to, 

r5l 

<£4, 

rS? 


for a five-record database, with four numeric fields used from each 
record. 

Finally, ViewStore asks for a name for the link file. The CREATE 
command does not need to be used as the LINK utility does this 
automatically. As far as the LINK utility is concerned, the link file name 
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does not need to be of the form V,vs<number>', but the file must be 
called that so it can be read by VicwSheet, So type in a filename like: 

output CiiefiaiBe? v.vs'J 

When the link file is complete, it will usually be necessary to copy it onto 
the disc containing the relevant spreadsheet. 

adfs. Net: The filename can be much longer, and the file can be 

created directly in the ViewShect directory where it will 
eventually gel read: 

S.VSHE£f*V,VS7 

would create the file 'vsf in the vsheet v directory, 

Figure 15,2 shows the creation of a single column link file with 24 rows 
to cam« the invoice amounts from the CREDIT example database from 
Chapter Seven, 

=>UTILITY LINK 

LIKK 

Use select file (N t t) 7 t 
Field 11 AMOUNT 
Field 27 
1 field 

Output file name? V.VSfl 

Creatina file.,*. . . tiT+tT , 

me is I by 
=> 

Figure 15,2, Creating a link file from ViewStore, 

In ViewSheet a cell could contain a formula like: 

READ CSt It Si 

to read the invoice amount for the fifth company in the VfewStOre 
database, or at least the fifth in the selection file. Thai is column one, 
row live of the array Any blank fields in the database gel written into 
the link file as zeros- 

The second method of producing a link file from a ViewStore database is 
via the REPORT utility described in Chapter 12, This offers the prompt: 

Send cota 1 !i to Unking file m*?}? 
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Answer V (for yes) to create a link file. The idea behind this is that any 
register values used on subtotal or total Lines in the report are also 
written to a linking file. Only subtotal and total registers can be sent to 
the link file. If the total line in the report definition file were: 

T.tfalft»■ -Hal <2..-Field List- —- 

T Total (ex VAT) ££§&»£« One VAT) £«««-» ITA / 1.15. HA 

then two values would get sent to the linking file. The REPOST utility 
asks how many columns there should be in the link file. No w enter the 
maximum number of register values printed on any subtotal or total 
line. In (he example just given, the link file should clearly have two 
columns: 

How rflany total* across? 2 

After printing the report, the lutk file is created and the size of the file is 
displayed The link file is produced even if the report is only displayed 
on screen, when "S' is typed in at the Screen or Printer?' prompt 

There are a couple of problems associated with link files created using 
the retort utility. First, the file Is arranged so that the first row of the 
link file is the total line, and the subtotal lines follow after that. Odd, 
but not necessarily a problem. For a file with three subtotals and a total, 
each line using five registers IA to IE, the rows and columns of the link 
file are arranged like this: 


I TA 

ITB 

ITC 

!TP 

ITB 

ISA* 

1 SB I 

I SCI 

! SRI 

|SEl 

l$A2 

ISB2 

|3C2 

| 502 

|5E2 

13*3 

I3B3 

I5C3 

1503 

|5Ei 


Now what happens if the subtotal lines use only three registers? 

ITA its itc itb ste 

ISA1 |5BI |SCI 0 0 

I5A2 150.2 1SC2 0 0 

|5A3 ISB3 JSC3 

Most of the subtotal lines are filled out with zeroes, but ViewStore 
doesn't bother to fill out the very last subtotal Line if it uses fewer 
registers than the total line- This means that ViewSheet can't read 
those values, '7£rror is displayed in spreadsheet cells that try. If this 
happens, then make sure that the subtotal lines print the same number 
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of registers as the total line, Do this by inserting extra @bbb patterns at 
the end of Halil, and matching them with ISZ in the field list. This 
ivon't actually make any difference to the report (11 f Z remains zero, it 
will only prim blanks), but it will fill out the link file. 

The second problem with link files generated by REPORT arises when 
there are multiple subtotal lines: 

T.Haiti. 
s 

S Total 
S Average 
5 

Each time a subtotal is needed, four tines are printed (two of them 
blank). But only one row of the link file is created. What happens is that 
the figure from the second subtotal line is put into the link file, but is 
immediately overwritten by the figure from the third line So 
ViewSheet can only read the last figure. The only solution is to make 
sure aU the important values are on the last subtotal fine (not counting 
blank tines) in the report definition. 

With both these ways of creating a link file, through link or through 
rufurt, the number of columns is fixed, either by the fieldnames typed 
in P or by the registers used In the report definition, 1 lowever, the 
number of rows depends on how many records there are in the 
database, how many there are in the selection file, or how many 
subtotal and total lines are generated by the report. 

Building a Spreadsheet System 

A complete system for printing invoices has been chosen for detailed 
description, as it incorporates an extensive range of the advanced 
features of ViewSheet. 

The system is intended to allow invoices to be typed in and printed out 
as simply as possible. Calculations for carriage costs, vat and totalling 
are done automatically by ViewSheet- 

In the example, the invoice total is made up of the sum of the costs for 
various items, plus a delivery charge, and value added tax The item 
costs are the unit price for an item multiplied by the number bought (so 
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two units at £20 each makes an item cost of £40). Each type of item is 
allocated a carriage code indicating the cost of the method of delivery. 
The total deli very cost of an order depends on the item that is costliest 
to deliver. If an item costs £1 to deliver and another costs £2, the total 
delivery cosl for the two items hi C2 


The Invoice Spreadsheet 

Figure 15-3 shows an almost completed invoice model. Its structure 
follows the description just mentioned. Up to 10 items purchased can be 
put In celts A7 to A16, their product codes in column B and the number 
bought in column C. 
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Figure 153. The invoke model. 


The formulae for the prices in column D use LOOKUP to find the product 
code in a table starting at A2&, and they return the price from the table 
at B2S, For example, the price formula in cell D7 is: 

LOOKUP tar, A28 A36, B3&) 

A similar formula is also used for the carriage codes in cell E7 P to return 
the corresponding code from the table starling at C2B: 

LOOKUP !B2, A£0 te6, C2$ C36) 
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This and the price formulae con be replicated down wards to the other 
nine cells available The costs in column F arc the totals for each line of 
the invoice, C7 * D7 for example^ in cell F7. 

The carriage cost in cell Elfi is calculated by the formula shown in the 
status area of figure 15.3. This works by taking the maximum value of 
the carriage codes in the range D7 D16 (which vary between one and 
four for different items!, and using this to choose one value from those 
held in a table starting at F28. Each carriage code from the price list 
table identifies a 'postage cost band , and the band charge is held in a 
separate table. The advantage of this approach is that the postage costs 
can be seen and changed more readily than if they are held within a 
formula or spread throughout the price list table. Figure 15.4 shows the 
price list ana carriage band charge tables. 

Mote that there is a zero in the price list; this is so that an empty cell 
(value zero) chooses a zero price and zero carriage band. The zero 
carriage band Is used in the CHOOSE function, to give a zero delivery 
Cost. Without this value,, the empty cells would cause ^Errori to be 
displayed in some formula celfe. 

The subtotal formula in cell El 9 of the invoice model is of course the sum 
of the range E7 E18* The vat is calculated as a proportion of this subto¬ 
tal. using the percentage rate held in cell F2&. Again, it is better to hold 
this rate as a value in a separate cel}, than to embed it within a formula. 

Finally, the invoice total is the sum of the subtotal and the VAT. Two 
further points to note are that the number format for window 0 is set to 
D2RM, and that all areas of the sheet except that for entering details of 
a sale are protected to prevent inadvertent alteration of the formulae. 
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Figure 15.4. Price list section of the invoice model. 
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Printing Out Simple Invoices 

While the model calculates the amounts properly as it stands, it is 
unacceptable as a record of any transaction. Were the model printed 
out, labels such as sm all-time gadgets ltd, in cell Al would be 
truncated as they are on the sheet display, A set of printer window 
definitions can he used both to present the necessary information in a 
better layout, and to hide any unnecessary information, 

The following represent a highly acceptable display: 


Wi 

TopL 

BotR 

POS 

0# 

BW 

Fait 

Opt 

0 

AI 

l» 


7 

7 

D2RM 


PQ 

Al 

A4 


SO 

7 

FRM 

ran 

PI 

A5 

Al 6 

BQ 

24 

7 

FFM 

T$ 

P2 

C5 

CIS 

ftl 

5 

7 

DORM 

T5 

F3 

D5 

MG 

B2 

7 

7 

P2RM 

TS 

P4 

F5 

F16 

R3 

8 

1 

D?RK 

TS 

PS 

Al 0 

A22 

B1 

24 

7 

FRM 

TS 

P6 

El 8 

F22 

B3 

0 

7 

D2RH 

TS 


Notice the variations in column width, and in Ihe number format. 
Obviously the money values are printed out with two decimal places, 
but values like the number of each type of item sold should be printed as 
whole numbers, 

When these windows are set up, the window scheme can be tested by 
reluming to Command mode and using the SCREEN command. The 
model Ls displayed on the screen, using a layout controlled by the printer 
windows.- and any small adjustments necessary can be made. It J s a 
good idea to put in some dummy data temporarily while this is done. 
When the windows are correct, it is wise to save the window scheme 
using the $W command. Finally, the whole model can be saved as a 
mask: delete the example data, and a blank model consisting of just the 
data, labels and formulae can be saved, using a name such as M .INVOICE 
for example. 

To prepare an invoice, load the NLINVOICE mask file, and enter the data 
on each item purchased: a description, the number purchased, and each 
item's stock code. Calculations and totalling are done automatically. 
When the model is correct, return to Command mode. Load the 
appropriate printer driver, then simply use the feint command to 
produce an invoice, Figure 15,5 shows a typical result, 
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Figure 15.5. An example printed invoice. 


Refining the Invoice 

An invoice number is shown at the top of figure 155. This serial number 
increases by one every time a new invoice is created To set this up is 
not a simple procedure, so follow the steps below exactly: 

1) Open a link file to hold the serial number, using die command; 

CftEATE 100 1 1 

This creates a file called V.VSlOO'* and sets the serial number in the 
file to zero. 

2) Load the mask file and enter Sheet mode. Unprotect row three 
using SHIFTH6. 

3) Enter the formula WHITE (100,1*1, -5) in cell B3, and then delete it 
with SHIFT-19. 

4} Now enter this formula in cell B3; 

WFLlTEflftOp I, 1 P READ (100. 1, 19 + <B3 <- 0)9 

5 ) Restore the protection on row three. Now press RECALCULATE (key 
SHFTH7) until the value shown in cell B3 is zero. Once this is done. 
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make no further changes to the model, Return to Command mode 
and resave the mask file. 

This procedure relies on a complicated circular reference. The way it 
works is as follows. The formula in cel! B3 reads the serial number from 
the link file, then adds the conditional value (B3 <~ Q) before writing the 
serial number back to the link file But the value of cell E3 is the serial 
number written to the file, so the condition is false. Thus, nothing is 
added to the serial number,, because false has the value zerof 

But when the mask as first loaded to prepare an invoke, the cells contain 
the values they held when the mask hie was saved. When saved, cell B3 
contained zero. So the very first time the invoice mask is recalculated, 
cell B3 finds that B3 <= 0 is true, and thus adds one to the serial number. 
The important point is that this happens only once for each Invoice- 

Saving the mask with a zqjq value for cell 133 is accomplished by steps 
three to five above. The file is seeded with minus five value by the 
dummy formula in cell S3, and is incremented to zero by recalculating 
the final cell B3 formula- 

Prinling the serial number on the head of the invoke, as shown in figure 
15,5 can most easily be done by altering the definition of printer window 
zero as follows: 

wi topi* SQtft Fob c* Bw Fjm opt 
P0 A1 B4 2i 1 DBLM TSZ 

and editing cell A3 to read 'INVOICE number. 

For a really professional-looking result, more text might be required at 
the top of the sheet; giving the address of the company and so on. This 
could he typed onto the spreadsheet in the same way as the company 
name. But a better result can be had by using the V5JCFER spooler from 
Chapter Six instead of printing the invoice directly. The spooled file can 
then be merged with a standard page from VIEW and printed This can 
all be done via an exec file or even a function key definition, so all that's 
necessary is to load the invoice mask, add the product data, then *EXEC 
the file or press the function key, 
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The file or key definition needs to mimic the following command^ 

vsxfer 

PRINT 

INVMOD 

*no m 

SEN 

LOAD INVTGP 
READ IHVMOD 
READ IMVBOT 
printer rxeo 

PRINT 
PRINT 
*SHEET 

Tills uses a spool hie INVMOD to transfer the mtudeJ from VlewSheet to 
VIEW. The other files JNVTOF and [NVfeCiT contain standard text for the 
top and bottom of the invoice page, of which two copies are printed. 
One file might include the company address details, the other an 
explanation of the trading terms and conditions. 

Small Errors in View Sheet Mathematics 

One of the most perplexing problems with ViewSheet is the so-called 
'small errors' problem. For a demonstration, type NEW to dear the 
spreadsheet, then go to Sheet mode and edit the default window 
definition to give a column width of 15, Now enter the following 
formula irt cell A1: 

G + 0,3 

The value of the formula should dearly be 63. Many fractions can be 
ex pressed exactly in base I D: a tw entieth is 0,05, a fifth is 0,2 and an 
eighth is 0,125, Hut machines can t always use as many decimal places 
as are needed. Imagine hying to express one eighth with only two 
significant figures - 0.13 is the closest it is possible to get; rounding is 
necessary. It's a bit like that with ViewSheet, It can only use 32 
significant figures in binary. The nearest it can get to the true figure of 
6 3 is 6-300000001 Try 7.8 too. 

The window or cell formats can be used to control this problem. If a 
number should be an integer, with no fractional part, use DORM, This 
doesn’t change the actual value in the cell F but it stops any tiny error in 
that value being displayed- Alternatively, use of the INT function at 
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strategic points in the model may be useful. Be careful with i m, as L\rr 
(Al) won't give the rounded value but a truncated one: int £A1 + 0 5) 
gives the rounded value of AT, 


Error Messages 

There are really three sorts of errors that may appear on the sheet - 

The most common is when a symbol appears in a cell. This means 
that the value of the cell cannot be displayed using the current display 
format. Either widen the columns, or change the display format. 

At other times 7Error' appears The full error message appears in the 
status area when the cell cursor is moved to the slot in question 
Common messages include 'Division by zero 1 , 'Lookup 1 and 
'Propagated'* Tnese messages may occur for two reasons. Sometimes 
there really is on error in the construction of the sheet, and a formula 
may need to be modified. But often they turcur when preparing masks; 
because there is no data, many cells have a zero value, and these zeros 
can cause the problems. When data is added, the errors simply 
disappear This is a good reason for preparing masks with dummy 
data, and then only deleting the data once the model works. 


Program Listing 15.1 

ID REM ftWLlW Bead/write Link files 
ZD REM by Gtaham Bell 
30 REM far BBC B/’B + ZM/C^E 
40 REM (C| Graham Bell 1580 
SO 1 

tiD PRINT "RKLINK" 

70 ERROR PRQCerror(O) 

eo i 

90 REM open Link fi L*s 
LOO handle* ■= FK-Qpan{ # lO0"l 
110 ; 

120 REM equivalent of WRITE(100,1,1,0> 
130 PRQC*rit& fhandle!i h L, 01 
140 j 

150 REM equivalent of READ(l&d,1*13 
ISO PRINT H FNread{handle*, 3, it 
170 s 

100 REM Close Link file 
150 CLOSE# ?ftarvdle* 

200 END 
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3tl0 
220 
210 
240 
250 
260 
210 
200 
250 
30 C? 
310 
120 
330 
340 
350 
360 
370 

im 

390 
400 
41D 
420 
430 
440 
450 
460 
470 
400 
490 
50O 
510 
520 
530 
540 
550 
5i0 
570 
500 
500 


: 


DEJ- PfiOGl* rite* ft, **, y*, 
IF (K% < 1) OR {«* > r%m 
IF (y% < I) OR (yl > £*72] 
PTS.4 ?F% - 6 * t(y% - 1) * 

FRINTl 7f%, n 
ENDFRDC 


Pi 

THEN FHOCerror il) 
THEN PRDCerror<2) 
f%?l + *!) 


DEF FWni*d<f%, «%, 

LOCAL rt 

IF fjti * I) OR (Kl > f\lll THEN PftOCerror U ? 
if fyl ■: n OR <y! > £'1721 THEN pf«>Cerror<2s 
PTF# m = 6 * (<yi - 13 * fill + Kis 
INPUT! ?fi, n 


* n 


DEE E'Nopen (f ile$j 
LOCAL f% 

DIM f% 2 

PKim ' '’Opening V t VS"; File* 

?fl = OPENUF C"V. VS+ £Ile$) 

IF ?fl = G THEN PRDCerrorUJ 
RTF# 7fl - 5 

IF BtsET# 7f% <> *AA THEN PFOCerroe^J 
PTR* ?fl = 3 
fV?2 = BGETf 7fl 
fl?l - BQSTt m 


L'ELE FRQCerror t numbe r %) 

CLOSE* 0 

IF number* - t TREK REPORT 

IF numberI = 1 THEM PRINT "k cooedInatu too big" 

IF number4 = 2 THEN PRINT a y co-ordinate too big" 

IF number! - 3 THEN PRINT "C*n*i find file 41 

IF number* = 4 THEN PRINT "Not Link Eli®" 

END 


Listing 1 5A Reading and writing link JPileS^ 
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1BOOT files 

An exec file can ease the process of starting up ViewStore. This is exactly 
the same as the process described in Chapter 13 for ViewSheet. A text 
file on a disc can contain the text that would normally be typed in to 
begin a work-session with the database. By using this file with the *DcKC 
command, or by auto-booting the Hie called I BOOT, the computer can act 
as if the text had been typed in at the keyboard 

The best way to construct an exec file like this is to begin by starting a 
ViewStore session in the normal way Each time something is typed, 
write everything down. Include all keypresses - RETURN is particularly 
important' Now leave ViewStore, and use a word processor or the 
*bUILP command as described in Chapter 13, to type in the text, exactly 
as jl was noted down. When saved using the name Iboot. type in 
‘+FX 4„T This sets the boot option; it means that the !BGOT Hie will be 
used with *exec. Once set up in this way, the ftSOOT Hie can be used 
simply by pressing SHIFT-BREAK, Conversely, *FX 4,0 means the 1BOOT 
file will be ignored. 

A typical ViewStore Iboot file might look like figure 16,1 This file enters 
ViewStore,. sets up the screen mode, the prefixes, and loads the 
database The *FX 202 command has the same effect as pressing CAPS 
LOCK to turn caps lock off. Of course, by using the DECODE program from 
Chapter 13, the screen colour can be set too. One important 
consideration L% that the [BOOT file always has to be on the disc in drive 
zero, so In this case, it should be on the same floppy disc as the database 
file Itself, The ViewStore utility disc goes in drive one. 
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•TV 0,1 
+FX 202,4$ 

*STORE 
MODE 3 
PREFIX D ?D. 

PREFIX F z2. 

PREFIX U si- 
PREFIX t i2* 

PREFIX S ;3.. 

LOAD BIBLIOG 

Figure 16,1* Typical ViewSture fBOOT flic?. 

Limited Access 

Quite often, a database mav be set up to be used by more than one 
person. It may be that different people need access to different parts of 
the database. Or maybe only certain parts of the database need frequent 
updating. Or perhaps the information is sensitive, and some users 
Should have only limited access to the data, ft is sensible to limit the 
accessibility of parts of the database for the following reasons: 
convenience, sensitivity, and security. 

It is simpler to be presented with only the important and relevant 
information. If the addresses of several companies on a database need 
to be changed, then a screen showing details of their credit standing is 
confusing. It is possible to use several different card or spreadsheet 
layouts, each tailored to doing a different sort of job on the database. 
One card might be arranged for entering the initial details of a new 
record, one might be designed for doing the regular monthly 
amendments to credit standings, a third could be for amending address 
details. The cards could show different fields depending which are most 
important for each job. 

The second reason for limited access to the database is sensitivity This 
doesn't mean keeping sensitive information on the database away from 
prying eyes, nor the prevention of deliberate tampering with the data* 
ViewStore is not that sort of database - its files are not encrypted, it is 
not password protected, it is not meant for 'multi-user' operation on a 
network Only physical security, putting the database discs somewhere 
safe, can maintain the confidentiality of the information. But it can at 
least he made difficult for the casual user to see restricted and sensitive 
parts of the database. 
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Net: Consult the network manager about the implications of 

keeping any sensitive information on a network. It can't 
be kept fully secure using Econet, and this may violate the 
requirements of the Data Protection Act. 

There remains the problem of altering the details of a record. How easy 
is it to alter one of the fields by pressing the wrung key accidentally, 
when browsing through the database? Fields apparently starting with 
the characters *_* or T are often caused by this, because of those 
keys' proximity to the cursor keys. Again, a card or spreadsheet layout 
that allowed only the relevant information to be changed could ease 
matters. 

This can all be done by having more than one format file for a database. 
The format file contains all the details from the record format, the 
database header and the card layout. So by using a different format file, 
the da I abase could appear completely different on the Card display, in a 
different screen mode, even with different field names or prompts. 

Creating a New Format File 

At the very beginning, the database has to he created by using the SETUP 
utility. This puts a database file in the *U directory, a format file in the 
F directory, and possibly one or more index files into the T directory. 
But it can only create a single format file. 

When the database is set up properly,, this master format file will contain 
details of all I he fields in each record, their fieldnames, their widths, 
their places on the card display, even their numerical high and low 
limits A brand new format file is best created by using a copy of the 
master format file. A copy could be made using the ♦COPY command, but 
ViewStore has special commands to load and save format files. 

To create a second format File, first load the database in the usual way. 
Then use the command: 

5F xflLsnanO 

to save the format in the file named. As usual, the F prefix is used in 
naming the file, but I his can be overridden by typing in the full name. 
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Assuming the F prefix was set to ,m 2f t ( hen: 

Sr ADDRS 

would save a new r format file called '^faddrsL But a file called 
':i,G.ADI>RS“ could be saved by typingi 

5F i1„ G .ADORE 

At this stage, the new file is exactly the same as the original, master 
format file. Any number of copies of the master format file can be made 
in this way. 

It is important to keep the master format file unchanged, ft is a good 
idea to 'lock" the file, using the *ACCtS5 command. 

□FS ^ACCESS <f ilcin jjsib> L 

ADts / Net *AJCCBSS WRL 

A locked format file can be used in the usual way, except that it can J t he 
modified. So if the database header were changed* for example, then 
pressing ESCAPE would give a 'Locked' error message. Pressing any key 
after that returns to ViewStore Command mode, but the new details are 
not saved in the locked format file. 

Using the Second Format File 

When there are two format files, which one is used when loading the 
database? Taking the example of the Membership database from 
Chapter 11, the files were called: 

□members Database file 

F. MEMBERS Master format file 

F.ADDRS The new format file 

Naturally, ViewStore tries to use the format file matching the name of 
the database file, unless another name is specified: 

LOAD MEMBERS Loads DM EMBERS and F, MEMBERS 

LOAD MEMBERS ADDRS Loads D.MEMQEICS and F.AHDR5 
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As an alternative tn naming the Hie when the database is loaded,. 
ViewStore provides an LF command to change the format file at any 
timcL 

LOAD MEMBERS 
LF APPaS 

The original master format file can he loaded again later by entering the 
command 'lf members 

Payroll Database Example 

Figure 16.2 shows part of the main record format far a company payroll. 
It is divided into three major sections, the employees' names and 
personal details, their addresses, and their salaries. Each of these 
sections Ls Labelled on the Card mode display with its own dummy field; 
PERSONAL, ADDRESS and SAL\R¥ The card display is shown in figure 
16.3, 

39476 _ 


Fiwl4 AM 


Fi*ltf inn *m - 


Flrnt nai"i 

ID h Tf 


10 h t 

Ji3b TlH- 

14 T T 


B fc ¥ 

Ham 

• D N 

JVxirwri 

SQM 

CiLEIOLt £ 

SIM sraa 

Cnraltiiro 

$ A H 

Frerioui 4 

SMS 1CHM 

Uit rtH 

MN 

Addm* a L 

30 T T 


ifl T t 

Mdtmtt 7 

JflT! 

Addciiia 4 

15 T ¥ 

Ph=*iP 

UT K 

PERSONAL 

q 

3A1ARV 

0 


4MOO 

SMOG 


Figure 16.2, Payroll database master record format, 
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Figure 16.3. Payroll database 1 master card layout. 

This layout is fine for the person in charge of the database^ perhaps a 
per&One! manager. But simply keeping the address records up to date 
can be done by someone else without necessarily giving unrestricted 
access to salary information. The principle is to have different format 
files for different levels of access 

A second format file can be created using SF, loaded using u> and 
modified to hide some of the information. The modified format is shown 
in figure 16.4, Fields can't be deleted from the record format using 
SHIFM9. To hide the information itself,, all that need be done is to set 
the width to zero. This makes any field disappear from the spreadsheet 
display, and prevents the data from being modified- But as with dummy 
fields, t he field name is still shown in Card mode. To make this 
disappear too, just delete it using delete end OF FIELD (key f3). This has 
been done to nine of the fields in the modified format, leaving only the 
name and address fields* Accordingly, the sample record card shown in 
figure 16*5 hills to show the complete record. Notice that even the 
dummy field, salary, has been hidden and another name, has been 
modified. 
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Figure 16.4. Modified database format, showing hidden fields. 

L Spate 29342 Indexed by erttrV 
Udine phono number: 

HAME 


EMPLOYEE 


First name Patricia 
5 4 :pa Pe MacDonaId 


ADDRESS 

Address I 1 Trinity Terrace 
Address Z ChorIt dil- cum-Hardy 
Address 3 Manchester 
Address A W2i SQ7- 

Phene 

Figure 16.5, Card mode display using the modified format. 

With this payroll database, it may he best to name the edited format file 
the same as the database file, so that it is used by default. The master 
format file can be renamed, so that it requires a positive act to load it in 
with LF. 

Two important yearnings. First, this payroll database is only a record of 
employees' salaries. So simple a database could not be used to replace a 
proper pay roll accounting system. Second, limiting access in this way 
does not prevent access to the hidden fields; it merely makes it slightly 
more difficult for the casual user. 
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The idea of having various levels of access to a database can he 
ex tended. It's possible to have several format files, each hiding or 
revealing different parts of the same database, each tailored to the 
needs of a different task. 

Joining Databases Together 

Another way of using a second format file allows brand new data to be 
added to the database, without access to the database itself! This 
involves putting the new data into a miniature version of the database 
file, which can then be added to the main database later. 

The general procedure involves using the sftup utility to create a blank 
database, on a new disc When set up r the format file can be deleted, and 
then replaced by a copy of the formal file from the main database. The 
procedure is shown in figure 16,6, using a main database called MAIN 
and a new database called MINT, The command SF MINI overwrites Ihc 
formal file FJM1N1 Iba! 5ETTUP created, and replaces it with a copy of 
F-MAIN, 

=>OTILIT¥ SETtfV 

SEW 

sot up database or report iD r Rj? D 
Filename of database? Mliil 
Format filename idet abase narceJ t 
Udv many bytes to reserve l 0 
Nuraiber of indent**? 0 
Creating Fomat file 
Creating Database file 
Database set up 

-change discs ot directory— 

= >LOAI> MAIN 

-change discs or directory-* 

- St HIEStl 
*>LOAO Wist 


GF5 


AOFS/Net: 


Figure 16-6- Creating a miniature database. 

As MINE and MAIN should be on separate discs, changing 
discs will be necessary. 

Changing discs on adf$ involves the use of the AMOUNT 
command; changing directories may be necessary too, 
using *DIR. 
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Net: The miniature database could even be created using a 

different user name, to avoid contact with the main 
database. Consult the network manager, 

Once the MINI database is loaded, switch off aU indexes, by putting or 
*N f in the record format T column, There is no point in having any index 
files, and switching them off saves a lot of time while entering new data. 
When the miniature file is set up properly, new records can be entered 
without any reference to the main pari of the database. Simply load it in 
and use it just as if it were a complete database. It is even possible to 
have several miniature databases, all being worked on at once. 

The only problem is how to join the main and miniature databases 
together. This can be accomplished with the JQ3ft program listed at the 
end of the chapter. 

The JOIN Program 

Superficially, all that is required to merge two databases is to append 
one file to another. There are numerous ways of doing this, and 
programming toolkits often provide a method of concatenating files- 
Computer Concepts' Disc Doctor implements a *JOIN command. 
However, this ignores the special View-Store file structure. All 
ViewStore database files include an end (if data marker, but the 
concatenated file would contain two! 

ior\ is a basic utility program enabling one or more miniature database 
files to be appended to a main ViewStore database, retaining the correct 
file structure. Great care should be taken that the mini databases are 
created using a format compatible w-ith the main database There are 
no Limits on the maximum size of fields, records or files, save those 
imposed by ViewStore and the filing system in use. Deleted records in 
the miniature update file are not adaed to the main database. 

The program first prompts for the prefix to use for all the data files, This 
prefix works in exactly the same way as the ViewStore prefix, and ii can 
tie overridden by entering a full filename at any point. 

The second question is as follows: 

Name of naira database? 
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Enter the filename of the main database to which the records will be 
added- Remember that the prefix may be added to the filename. The 
program opens the main database file, and carries out a short check to 
ensure that the file is indeed a ViewStore database. If it isn't, an error 
message is printed, and the program ends. 

Wow the program asks for the name of the first mini database: 

Name of extra data file? 

Enter the filename. Hie new file is opened, and tested to see if it is a 
valid database. This test can't ensure that the field typos in the mini file 
are compatible with the main file. When the mini file is checked, confirm 
that the records in the file should be added to the main database. At this 
stage, if *N' is pressed, then the file will be ignored. If "Y" has been 
pressed, the program reads the records from the mini file, and appends 
them to the main database. The number of records transferred in this 
way is sho wn on screen when the process is completed. 

DF5f Great care is needed to prevent the "Can't extend' error. 

It will usually be necessary to have the main and mini 
databases on separate discs, or on different sides of the 
same disc with a single disc drive For example: 

prefix jO. 

main database maim 
mini database :i . d .mini 

The main file is called 'tf.DAUW, and the mini file is 
*:1. DAUNT'. Using a complete name for the mini file 
overrides the prefix. 

Finally, the program returns to the Name of extra data file?' prompt, 
and a'further small file may be added to the main database. Any number 
of files may be joined in this way, but take care not to add two copies of 
the same file And don't add a format file onto the end of a database! 
Mistakes are possible, and so as always, a back-up is vital. When all the 
small files have been added to the main database, just press RETURN at 
the 'Name of extra data file?' prompt. This doses all the files and ends 
the program. 

When a file has been added to a main database, the index files for the 
database will be out of date. They need to be rebuilt. Load the newly 
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enlarged database and its master format file, then use the INDEX utility 
to recreate all the indexes as follows: 

* -■UTILITY INDEX 

THDEX 

Use select file (N,YI? IT 
Field name? * 

-> 

The * wildcard specifies all the index files, ViewStore reconstructs the 
index files for the database, and includes the new records added with 
the JOIN COMMAND, 

Entering JOIN 

The JOIN program shares many procedures with the PURGE program 
from Chapter 11, PROCeod_ pointer, FNname, FNconfinn, FNopen, and 
parts of FROCorror. These need not be typed in twice. First, type in the 
unique part of JOIN, up to line 50Q r and save I he part-completed 
program. Mext load the PURGE program, and delete the unique parts up 
to line I960. The remaining part of purge can be added toplN. Type: 

renumber 5000 

*SPOOL SHARED 

LIST 

•SPOOL 

LOAD “JOIN" 

■EXIC SHARED 
RENUMBER 

This creates a file called SHARED, which contains the shared procedures, 
and these are then added to the end of JOIN. 

JOIN works by opening the main database file, and reading it backwards, 
searching for the ViewStore end of data marker in the file. When found, 
the mini file can be opened, and data copied from one file to the other 
until the end of the mini file. The original end of data marker gets 
overwritten, but the one from die mini file is copied to the end of the 
extended main database. The ESCAPE key is disabled whilst the 
database is being altered, but BREAK should not be pressed while the 
program is running If it is, then the files may be left open and the 
database corrupted. The back-up copy of the database would have to be 
used. 
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ViewStore and VIEW 


Anything ViewStore prints can be transferred to view by loading the 
V5XFER printer driver described in Chapter Six, Reports, labels and the 
printed output of any of the utilities, all can be pufinta a file using 
vsxfer, then read into Vi£w. This is most useful with the label or 
report utilities, where the output may need to be edited before final 
printing, or merged with other text to form a larger document. For 
reports in particular, the more sophisticated page Layout features of 
VIEW may be needed too. The MACRO utility described in Chapter 11 
allows direct transfer of data to VIEW. 

But vi IW can a bo read whole ViewStore databases directly, In view, a 
database Ole can be read in using the read command. Figure 167 shows 
part of the Bibliography database read into view. Notice how the tab 
stops of the ruler have been arranged to align the fields of the database 
in neat columns. This works because ViewStore uses TAB characters to 
mark the end of a field. 
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Figure 16.7, ViewStore database read into view. 

Difficulties will sometimes arise in reading database files, when the 
amount of data in a single record exceeds about 125 characters. VIEW 
allows a maximum of 132 characters per line, and if more are read, then 
VIEW splits the line into two. 


Tables written in VTEW and laid out like this, can also be converted back 
into ViewStore databases using import Unlike the other utilities 
supplied with ViewStore, IMPORT is □ basic program. Enter basic and 
run the program It asks a series of questions about the file to be 
imported, then reads it in and creates a ViewStore database. Figure 16 M 
show's the sequence of questions and the answers necessary to import a 
view file like that in figure 16.7, A TAB must separate each of the fields 
w ithin a line, and each line of the text file produces one database record. 
It is best to delete the ruler beforehand. 


252 




ViewStore Hints And Tip* 


> CHAltf "IMPORT* 

VievStore flic conversion VI.1 
Source file 
Destination file 



Position in file where data start* ; 0 


accord separator 
Appears before first record 
Appears after last record 
Field s atOr 

Appears ore first fieild 

Appears after last field 
End of file tear Jeer 
Is the data reversed 
Leading character to skip 
Trailing character to skip 
ViewStore record size 
Importing V1EWTXT 



V j ? ti 



(Tfi») ?» 
t*i«] ? w 


; 13 


Figure 16.8. Importing a VIEW file 


When import finishes, it displays the number of retards that have been 
read and transferred into the destination file, import doesn't create a 
format file for the newly imparted database. The easiest way to create 
one is to save one using the setup utility, or use the 5F command from 
another database, The new database can be loaded into ViewStore and 
the format Hie modified to match the new field structure. 

The second sort of VTEW file that can be imported is a macro ffie’Ehat is a 
file consisting of nothing but macro calk. The import ant point is that 
there must be nothing in the file except macro calls, not even a ruler. For 
example: 

i 1 i... * *. . ■ ...... ■ „ + . ..... 1 ... ..., m .. „. *.. *. .i. * *, . *. ^ * 4 < 

AA Bncm Ho^ndrl-J Ttowrancts Tojrrodc,flickrnjiiBvwth,Mtddi. 

AA Jessica ELIia^riat ■«Suffolk HansiQna> # 51okeley Gtran,London mal 

AA nfifijj Jajnes*2 The 

The answers to the questions posed by the IMPORT utility to import a 
macro file are shown trt figure 16.9. The field separator must be a 
comma. The record separator must indude the name of the macro, in 
this case 'AA'. Sadly, import can't deal with the case where a macro 
parameter contains a comma, as in the second line above, although the 
parameter is enclosed in angle brackets, import treats thk as two fields. 
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Position in file where data 
Record separator 
Appears before first record 
Appears, after Last record 
Field separator 
Appears before first field 
Appears after last field 
End Of file marker 
is the data reversed 
Leading character to skip 
Trailing character to Skip 
ViewStore record size 


starts i 0 

s i3,i2a/"A” J ,i ir 
<¥*W1 t t 

? » 

" ™ r " 

a t m ? m 

iY r H) 7 B 
1N # Y) '* H 

i +20 


Figure 16-9. Importing a VIEW macro file, 


The ViewStore manual describes the procedure necessary to import flies 
From Ashton Tate's dBase 11 and AcomsofFs Database. In fact, the 
answer given for dBase II can be used to import almost any database, 
providing it can be turned into an ASCII file, one record per line, with 
commas between Gelds, 


Adding New Fields 

With an established database in regular use, the need for an extra Held 
will inevitably arise. Adding the new field is an easy job, providing that 
it can go last "in the record format. This means that it will appear at the 
very end of the Spreadsheet mode display, but of course the Card m(Kle 
display can be altered to place the new field any where. 

If the extra field is to go at the end of the record format, then adding I he 
new field is simply a matter of loading the database, and editing the 
record format tkey M). lYess CTRL-DOWN to go to the last line, and enter 
the details for the ne w field. Press fo to go back to the data screen, and 
all that remains is to enter the data in each record for the new field. 

The rarely noticed CURSOR LOCK function (key SHIFT-12) may be vital 
here. Usually, there is an F U flag in the upper left-hand comer of the 
data screen; this indicates the field cursor is 'locked' to a particular field- 
pressing DOWN moves the field cursor to the corresponding field of the 
next record. It stays in the same column of the Spreadsheet mode 
display. Now press SHIFT-12, so the 'U flag - f umocfaed f - is shown, and 
press DOWN again. The Field curaor moves down to the next record, but 
instead of staying in the same column it jumps to the first field of the 
record. For adding data to one particular new field, obviously the 
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cursor should remain locked to that field. Remember that RETURN 
doesn't need to be pressed, just type in the new data and press DOWN. 

Adding a new field somewhere in the middle of the existing fields, say 
putting a post code field between the last address field and the telephone 
number, is more tricky. The CONVERT utility is the only way to do this. If 
the fields are displayed using the LIST command: 

1 Name 2 Address i 

3 Address 2 4 Address 3 

5 Phone 

the new field can be added between field 4 and field 5 with the procedure 
shown in figure 16-10. Nolle? that a *? wildcard can be used to specify 
all the address fields together; they are transferred to the new file in the 
same order as in the old file. Once the database is fully converted, LET 
would produce: 

1 Hajfig 2 Address 1 

3 Address 2 A Address 3 

5 postcode 6 Phone 

Well, actually, it won'tt But it would if the record format were altered to 
match the structure of the new data. CONVERT does not alter the format 
file to match the new field order It also doesn't keep the indexes up to 
date, so aU ihe indexes have to be rebuilt with the index utility They can 
all be done at once, as already shown. 

=>UTILITT CONVERT 

CQMVEP-T 

use select file CN,Y)? to 
Field 1? Name 
Field 21 Address ? 

Field 33 Postcode 
Field fl? Phon* 

Field 5? 

New record size |+20)? +30 
New file name? NEWADDft 
Converting records,.. 

2 A records processed 

Largest record was 166 bytes 
*> 

Figure 16.10. Adding an extra field to a database with CONVERT, 
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Extra fields can't just be sbttcd into the record format In the middle. 
They can only be added at Ihe end. This presents a major problem when 
CONVERT is used to alter the field order* or when new fields an? added. 

But don't format files have a structure similar to a database files? Can't 
database files be read Into view? And can't they be edited, I hen imported 
back to ViewStoie? Figure 16.11 shows the Bibliography database's 
format file read into VIEW. Notice the new ruler at the top of the text. 
The tab slops are arranged to emphasise the similarity with the 
columnar layout of the record format. As with reading database files, 
view places a 132 diameters per Line limit, but with format files this will 
only rarely be exceeded. 
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Figure 1 6. 11. Bibliography format file read into VFEW. 

When the format is in view, it can be edited. The first line of figure 16.11 
represents the database header; this is slightly different to the rest of the 
lines, which represent the rest of the record formal. During editing, it's 
best to leave the actual lines alone, but their order can be changed to 
match the way the database file was amended with CONVERT. The MOVE 
BLOCK function is best for this. Extra lines can be inserted, and new 
format information typed in. Remember to separate the columns with 
TAB, not spaces When everything is correct, delete the ruler line and 
save the VIEW version of the format fib in a file called, say, NEW FORM. 

The VIEW file can be Imported back into ViewSlore using the technique 
illustrated in figure 16.3, Enter BASIC and chain the IMPORT utility. The 
source file is the format file as modified by VIEW,, newfokm, The 
destination is a new format file in the ViewStore 'F directory, say 
F.NEWTORM, Don't overwrite the old format file F.BIBLIOG yet, in case the 
new format doesn't vvork as expected. Lastly, set the record sLze as -K>. 
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f 


Swap to ViewStore* and load the database using the newly Imported 
format hie: 

LOAD BXBLIOG MUfPOKM 

Check nut the new format by looking at the record format, the database 
header and the card layout. If all are as they should be then the old 
format hie, f.lubliog tn this case, can be deleted, and fmewfORW 
renamed to lake its place. 

Fixing the Format 

A trick that can be played with the format file is to add two extra bite to 
the database header. While the format file is in VIEW* add *Y' and "N K to 
the end of the first line. Compare figure 1612 with 16.11 to see the 
difference. Remember the new columns must be separated from each 
other by TAB character^. 


FI-..-*.*.■-V.,, -*--< 

». » _.. " . ..,,,,€ 

Bitlioarac^v ff +30 30 3 T N 

AUTHOR » A 10 i T t « AL/Tlt'S oT mvtlel*i 

TITLE hi li | | R H TITLE Tit I* □£ irticl*-; 


Figure 16-12- Fixing the Bibliography format file in VIEW 

When imported back into ViewStcre and used as a format file, pressing 
fi does not allow the record format to be inspected; the 'Fixed format' 
error message is displayed. This works because them are two 'hidden' 
fields in the database header. The second of these is called "Allow 
format edit', and if it is set to 'N\ then the record format can't be edited. 

The first extra hidden field is called 'Allow multiple records'- if that is 
set to N' then the Card mode display only ever shows one card. 
Normally, ViewStore displays as many cards as can be fitted on a single 
screen. If foe card is small* with few fields, then several can be shown at 
once. But if the first hid den field is set to N 1 , then only one card at a time 
is displayed. 
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Automation 

Repeating the same job frequently gets very tedious. If the database is 
used to print a big batch of labels every week, then the label utility can 
be 'automated* with an exec Jih% sometimes also called a command fik\ 
since it contains only commands. 

The best way to create a new exec file is to start by writing down 
every tiling typed in as a batch of labels are printed It's a good idea to 
keep a note of the prompts too. Usually, the notes will look something 
like this: 


PAINTER JUKI 4 
UTILITY LABEL 
* 

P 

a 

i 

35 

0 

1 

Hama 

Rddr«9« 1 
Addrai* 2 
Address 3 
Postcodfl 

RETURN 


¥ 


(load printer driver) 

(vs* seletl file) 

[use printer) 

(lines per labd) 
rbeiwetKrt labels) 
(characters per label) 
(between labels) 
(labels aemss) 

(first field an label) 


a d o a « j d 

(do alignment print) 


1 g a n 


it n ) 


l 


Now use +BLFTLD or a word processor to carefully type in just the 
responses. The completed file is shown in figure 16.13, as it appears in 
VIEW. Although label printing usually follows creating a selection file, it 
may not be worth automating the selection because I he criteria used 
might be different each week, Of course, if they are always the same, 
then include them in the file too. 


) 


) 

) 
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r i..*.. -,.*,c 

PBJIfTRS: 
tfriUTY 1A0CL 
1 
P 

e 

i 

}5 

0 

1 

i 

tedrva* 2 
HUraik 1 
hiksdt 

T 


Figure 16,13, LABEL exec file Ln VIEW. 

When the response text is typed in and saved in a file called, say, 
tLABELS, a new set of labels can be created at any time just by entering; 

*J5)U5C fUBXU 

it is □ common convention to start a]I exer filenames with an 
exclamation, but not vital. 

Master: Providing that fLABELS was created with *BUTLD, or byusing 

view's write command instead of save, then 
J *txBC! labels' can be shortened eo '^labels . This works 
with the Watford DPS on a standard BBC B as well. 

Most of the ViewStore utilities can be automated in a similar way, and a 
suite of exec files can make the day-to-day use of the database quick and 
very convenient. 

Anything that can be put in an exec file can also be programmed into a 
function key. To give key iO exactly the same effect as the exec file in 
Figure 16.13, the definition is: 

’ SET 0 PRINTER JUKI* tROTl LUX LABEL | MY IMF \MH | ML | Hi5 |HQ I HI | M 
Marne | M Address 1 [M Address 2 |M Address 1)M FostdddcHK IK/IH 

Pressing to would then produce a whole batch of labels. Notice that the 
RETURN key becomes M M J in the key definition which should all be typed 
on one line, pressing RETURN only at I he end. 

Clearly, a complicated key definition like this should be worked out 
beforehand, and the definition pul in the 1 boot file. 
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Program Listing 16.1 

10 REM JOIN VievstOrb database 
20 REM file joiner 

30 RfLM for S/B+/M/C/2P/E + Vie^i store 
40 REK [Cl Graham Bell 19$? 

50 : 

60 REM ViewStore file constant3 
IQ space* - 403 
80 end_of_fieid% « 409 
50 end_Of_feCOrct* = 4 CD 
100 end_df_data% = £01 
110 deleted! - *02 
UP pad! - *00 
130 : 

140 C*J ERROR PROCerror (0J 

150 PRINT "JOIN" 

160 : 

170 prefix* - FNname ("Prefix for data files*) 

1*0 name* = FNnajne ("Kerne of main database") 

190 IF fUSTRtnanfi *.*J * 0 THEN name* = prefix? + "D. p + 
names 

200 IF NOT FNcOirfirm ("Have you made a backup 41 ) THEN GOTO 4 90 
210 S 

220 big_file! - FNdpen (naflie$ p "U") 

2 30 tig_codi = FNeod_jiO inter £blq file!) 

240 : 

2SQ REPEAT 

260 tiny lllle$ = FNnarrre ("Maine of estra data fi le^l 
2?a IF tTny_ fiIe$ - "" THEN GOTO <~!Q 

2Ba IF JMSTRitlny = 0 THENtiny file? = prefix* * 

“O." * tiny file* 

290 t iny_f ilel = FNoper. itinyf Ue? f “R" J 
300 tiby_eod% - FNeod pojntflr”(tiny_fil*l) 

310 IF MOT FNconfirm 7"Add records") THEN GOTO 460 
320 : 

330 *FX 229, ] 

340 PTftf bln file! - FNkkI pointer (big filel} 

35D PTft# tiny_filei = 0 

3 CO records! = 0 

37D REPEAT 

3SG byte! = FNnext_byte (tiny file!j 
3SD BPtIT# big_filel, byte* 

400 IF byte! - end of record! THEN records! = records! * 1 : 
Print ". 11 ’ 

410 UNTIL EOF# tiny filfil 
42Q tW POS <> 0 THEN PRINT 

4 30 PRINT ; records!; " record £s I processed 1 * 

440 * FX 229, 0 

450 i 

4€Q CLOSE# tiny file! 
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CIO asm. tiny files = ■" 

CBD CLOSE* Mg“file% 

490 END 
500 : 

510 ; 

520 ; 

530 DCF FNedd pointer ifUe*i 
540 LOCAL ptr% r byte* 

550 ptr* = EXT! file* 

560 REPEAT 
5?0 ptrl - ptrl - 1 
550 PTR# file! - ptrl 
590 byte* = 0GSTI file* 

^00 UNTIL (byt£% <> pad\\ OR (ptrl = 0} 

510 REM only eod marker may pressed padding In valid file 
620 IF (byte* o end_of_d2stati OR (ptrl - 0) THEM PROCerror(2) 
G3G = ptrl 
640 ; 

650 DBF FNnane (prompt St 

G60 LOCAL nameS 

670 PRINT 1 prompts; 

630 INRUT "7 " names 

G9Q R£W delete trailing spaces 

700 REPEAT 

710 IF RIGHTScnames, 1} = " " THEM name® * LEFTSCnameS f LEW 
nameS - 1} 

720 UNTIL RIGHTS(names, 1] - * 

730 = names 
740 ; 

750 OEF FNconfirm (prompcS) 

760 LOCAL fceyS 
770 PRINT promptSj 
700 INPUT " (H r Y)7 * XeyS 
790 keys - LEFTS(key$, 1] 

600 = INSTRC'Yy^, key?) <> 0 
310 : 

820 DRF PHopen (nacne-S, controls I 
830 REM require?: Basic 2 
S40 local handle* 

050 controls = LEFTS(controls, 1) 

@60 PRINT "Opening name& 

870 IF controls - "R" THEN handle* = OFENIN namo$ 

€30 IF control? = m U* THEN handle* “ CPENUP name? 

S90 IF controls - "W* THEN handle* = QPFNGUT nams=S 

SQ0 IF fiandlel = 0 THEN RROCerrar <1( 

§10 - handle* 

S20 : 

93D DEF FNneKt byte (file*! 

940 LOCAL by tell 

950 byeel - BGET* file! 

960 IF byte* <> deleted* THEN = byte* 

970 REN read through deleted data 
960 REPEAT 
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9&0 bytrt - HOIST# flirt 
1Q-00 UNTIL byte* - *fid_ot record* 

1D10 REM now get next valid byte 
1 020 ■ FNnent byte £file%) 

1030 : 

I04C DEF FRQCerrbr (humberi) 

1050 22S,l 

1060 CLOSE# 0 

1070 IF numbtfC* = 0 THEN REPORT : PRINT 

LOAO IF number% = 1 THEN PRINT *Can fc t rind file" 

IQ3U IF number^ = 2 THEN PRINT "File not a database" 
HOC *FX 223,0 
1110 END 

Listing 16, L JOIN database file joiner. 
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Highlights in ViewStore Reports 

In ViewStore, highlights can u&cd in report definitions to make the 
printer use different effects, such as bold and underlining, if highlight 
characters are put in the field Eist for a particular report line, then they 
will take effect when the report is printed out, providing the 
appropriate printer driver is used The highlights are represented by 
jA V and ' A 2 r For example, if a report is defined as shown in figure 17.1, 
then the printed report will have the Item name printed in bold. As the 
report line is printed, highlight 2 proceeding the Item field switches bold 
on, and the second highlight 2 in the field list switches it off again 
aft erwards. 

...Kisra.rifcld t lh-...... 

Ji Its* in steak Fries 

athr cii.ii . it-*. -j, r Pn«, v.rn e**«*fc 

e aub-tsatM •rMhm t-iifl-fli is» 

£ 

t taui **hm £10h«i,ii m 

Figure 17.1. Report definition with highlights. 

Remember that items in the field list must be separated by commas; 
highlights are no exception. And remember to load the printer driver, 
with ViewStore's PRINTER command, before running the REPORT utility. 

However, there are a couple of problems with ViewStore highlights 
Taking this revised field list as an example: 

Item,"’l. Stock,*1, Fries,A:Price 

The first highlight is printed immediately before the stock field as 
expected, but the second highlight is not printed directly afterwards. 
Instead it is used immediately before the next field, the price 
information This means the prinlcd report may end up looking like the 

following: 


Tee pieces 


12* _ Jm 1.B4 
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Not only the number in stock is underlined: the underline effect 
continues until it is switched off at the beginning of the price field. In 
this case, the intervening pound sign is underlined too. Underline is 
used as an example of the problem because it is easier to see, the other 
highlights work in exactly the same way. 

A useful technique to get around this problem is to use a ifitmmy 
comment This can be p faced in carefully selected positions on the 
report line, to force the highlight sequences to be put in the correct 
place. The report line from figure 1*1 could be revised as follows: 

.* . 

r ebbb e tm.QQ 

Hie matching field list is: 

icenii *1, Stock, *1, ^Cl # erice, A:Price*Sto«X 

The extra @ in 1 lalfl simply causes a blank space to be printed in the 
report, because the comment is a dummy. But the important side-effect 
is that the space will be preoeeded by the highlight code, so underlining 
will be switched off before the pound sign is reached: 

Tea piacB3j 125 l 1-B4 

The dummy comment A C1 must be defined on an oxim line at the end of 
the report. Clearly, if there are already other comments, then the next 
number in sequence should be used as the dummy: 

T . HalO . ,.. , ,.... „ 

C Just press SLETURH 

When the prompt is displayed, just press RETURN as instructed, to 
ensure the comment gets printed as a blank. 

This idea is also useful when you need to cancel one effect and start 
another immediately. A space is necessary between the two groups of 
highlights, and using @ together with a dummy comment provides this. 
It also means that ordinarv text can be highlighted in a report. This: 

T.Halfi....... 

S § Sub-tot a I value fi 
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together with the field list '*1*0/1/Cl, ISA' should print as: 
fiuh-tataL vaiue £1275 >311 

Notice how the underlining can be made even on either side of the text, 
by offsetting the second © by a single space. This matches the 
underlined space at the start of the underlining, caused by the first <@. 

A dummy comment can also be used to incomorate the W character 
itself into a report. It can't just be put in 1 laltl or l lal£2 because there it 
gets interpreted as a pattern. But if a pattern is used and a dummy A C2 
put in the field list, the comment could be used to print W . The 
comment line could be like this: 

T.ttem,**..,.... . , * 

C Just press £ RETUEIH 

There is a second problem associated with highlights. It is important 
that all effects are cancelled before you begin the next line. If a 
cancelling highlight lies at the end of the field list this will not happen 
automatically. Another dummy comment could be used, but the best 
thing to do is to reserve one register to always be zero -1Z is probably 
the easiest to remember. Then assign zero to register fZ after any 
trailing highlights, to ensure they are printed. So the whole of the 
subtotal line could be printed underlined like this: 


r.Haiti*..-. ...- 

S @Suh-tQtal value EGiBeG.'S® 

using the field list'*1/0,1SA/1Z-O' Adding *ero to register IZ 
makes no real difference, but it does ensure the second highlight to end 
the underlining is used before the end of the line. If it just sits at the end 
of the field list {'*1/0,15A/H, then it is ignored, and depending on 
your printer the underlining may carry over on to the next line. 

When the report format is set up, print the report as usual using the 
REPORT utility. If a printer driver is used, the highlights will take effect, 
and parts of the report will be printed with the desired emphasis. If the 
V&XFER spooler from Chapter Six is used instead of a printer driver, 
then the highlights will go into the spooled file. VIEW can be used later, 
to read in I he report, including its highlights, and incorporate it into a 
larger document. If the Ascii spooler from Chapter Six is used, then the 
highlights will be ignored. 
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Extended Highlights 

The Acorn Printer Driver Generator includes an extra facility known as 
extended highlights, in VIEW, highlights 1 and 2 (keys SHIFP-T4 and 
SHIFT-15) work as normal to give underlined and bold effects when used 
with a primer driver. But if highlight 2 is redefined using the I rr edit 
command, like this; 


FIT 2 130 

then a whole new set of highlights can be used. 

Extended highlights can't be used at all with ViewSheet. Only the 
normal highlights 1 and 2 can be used, by including them in the OiT part 
of a printer window definition. This is described in Chapter 13. 

Although figure 171 uses just highlights A 1 and A 2, there are in fact nine 
highlights in ViewStore, A 1 to A 9, The nine are not redefinable - there is 
no equivalent uf VIEW S HT command. In the report definition field list 
A 1 and A 2 are used in place of the default VIEW highlights, to give the 
usual underline and bold effects But in addition, using A 3 will mimic 
the effect of highlight 2 after resetting it to 130 with the HT command 
Die possible extended highlight sequences for VIEW and ViewStore an? 
shown in figure 17 2, These extended highlight sequences can only be 
used with printer drivers created using the Printer Driver Generator. 


VIEW 
* * * 


VlewStore 

*1 

*3,^3,*3 
*3. n,*3 

*3, *3 
A 3, *3,*I 


begiq/end underline 
beginfend bold 
begin/end Italic 
begin subscript 
begin superscript 
end sub- or superscript 
begin/end alternate font 
reset printer driver 
□sed with ViewIndex 


Figure 17,2- Extended highlight sequences. 


The extended highlights can be used in exactly the same way as simple 
highlights, so the field list: 


"3, *1, "3. Item, *3 ( A l g *3p^CUStOck^lj^Cl,mcer, 
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could be used to print the Item name in itsilECS r the number in stock 
normally, plus the pound sign and price field underlined. Again blank 
patterns, dummy comments and the register IZ are used to ensure the 
Highlights are printed in the right places. 


Reports containing extended highlights can be transferred to view in 
the same way as normal reports, by printing them while using the 
vsxfeh printer driver. Note that the A 3 in ViewStore becomes highlight 
2 in the view file, and the *Ht 92®130’ command must be inserted at the 
beginning of the report once it is read into view. In ViewStore it is 
possible to use A 2 to control bold, even while using the other extended 
highlights, but it isn't a good idea. Use A 3, A 3, A 3 instead, to maintain 
compatibility with VIEW 1 The rule is to use A 1 and A 2 for underlining 
and bold, or use extended highlights in figure 17.2, but don't mix the two 
different methods. 


Printing Without a Printer Driver 

The routines described in Chapter 13 using special exec files to control 
the printer, can all he used with ViewStore as well as with VjcwSheet. 
Most useful are the NLQ, POUND and c:ONOENS programs. 

Editing Report Definitions 

The biggest problem with trying to make changes to report definitions is 
that new lines can't be inserted between existing lines. For example, if 
the report definition looks like this: 

T, Half! .,...«.*.***.*... 

R item Wn. in sto-cfc Page @(a 

H 

R £flbbb*hb 

& Sub-total i@bbtib*bb 

T Grand total E£bbbtob*bb 

then the Layout of the report can be improved by adding a few blank 
lines around the subtotals, But nothing can be added between the Rand 
the S lines, ViewStore allows a line to be deleted, but not inserted. 

It is a good idea to incorporate a few spare blank Vines whenever you 
devise a new report However, blank fines can't really be included in a 
report. The way to get around this is to insert several extra comment 
lines into the report. Then before pressing ESCAPE, use t3 {DELETE end 
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) 


QF RE ID) to deic‘d the C in the type column. The report definition should 
then look like figure 17,3. If this definition is used to print a report then 
the REPORT utility just ignores the dummy lines, because they don't have 
a type. Later, if lines have to be added to the report , then the dummy 
lines can be replaced by real ones. 

T.ftilfl***.** 4 ****.... 

E Jtem No, in stock Page 10 

H 

dummy 1ine 

R @@G f,§fcbb T fcw> 

dummy 1ine 

5 Sub-total t@bbhh,bb 

Brummy line 

T Grand total fcBbbtotah.bb 

Figure 173, Dummy lines in a report definition. 

For more heavy duty editing, report definition files can usually tie read 
into view for editing, just like whole databases or format files Switch 
to VIEW and use the ft FAD command to read a report file called 
'R OLDREF' as follows: 

NEW 

READ ft.OLDftEP 

Occasionally, very complex report lines with long field lists can't he 
read successfully, because the tine length exceeds the 132 character limit 
in view. 

Figure 17.4 shows the report definition from the previous page read 
into view. A ruler can be inserted to tidy up the look o«f the file. It should 
have three tabs, for the Half!, Half2 and Field list parts of the 
definition. Remember the columns am separated by tab characters. 






. . 

FI Ii« Jto. 

ifi stock 

fi9« 4« 

It 

Pi ilHEimHBM 

flU 

£$chb.tt 

lt«L 1 fcfua' * , V«1b* h A[ h «UK* 1 +y*iw 

3 5iUfei-tO*a4 


Mbbbb.bb 

l» 

7 GEifrJ totil 


tltiLtJij.bt. 

111 


Figure 17.4. New line added using VIEW, 
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When in view, new lines can be added at wUL using view's INSERT LINE 
function (key f6). The important part to add is in the Type column; 

Half!, HalO and the Field list can be added in view, or they can be left 
until later and added when the report is transferred back to ViewStorc. 
A single new subtotal line has been added in figure 17.4. Don't forget to 
get rid of the ruler line before saving llie amended version. When the 
edited report definition is saved in a different file, say VlEWMF*, the 
ViewStore tMrDRT utility can be used to get the definition back into 
ViewStore- The series of answers for this is shown in figure 17 3. It's 
rather like importing a normal database or format file, but the 
ViewStore record size for a report file is 300 bytes. In the figure, the 
definition is imported into a file called TCNBYR!]? 1 - 

= > l BASTC 
iZ&kiK "tHPQRf* 

ViewStore tile conversion VI.1 
Saurce file 
Destination file 

Position in file wherE data starts 
Record separator 
Appears before first record 

Appears after Last record (Y. f N) 

Field separator 

Appears before first field (¥,N) 

Appears after last field 

End df ill* nsarker 

the data reversed <N r Y> 

Leading character to skip 
Trailing character to skip 
ViewStore record sire 
Importing VIEWREP 
> 

Figure 175- Importing a report definition from VIEW. 

Report definition files take up a great deal of memory because they have 
a record size of 300 bytes. Even a short comment line with just the 
prompt Today's date?' takes up 300 bytes, A moderately complex 
report with 20 lines would take up about fik of memory! Although it is 
unlikely with a EEC model B+ or Master series micro, you may get a 
'Record too big' or 'Memory' fiiil' error when using the RETORT utility. H 
Is usually passible to switch to a different screen mode, perhaps mode 6 
or 7, But you can squash the report definition fiJe to leave mare memory 
free, either while using IMPORT, or separately. 


: VIKHRES 
i P.KEVREF 
; 0 
: 13 
? tf 
? I 
J 9 
* V 
1 N 
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An Imported report definition from VIEW can be compacted by 
answering one of the import program prompts differently, for 
example: 

Vii=wSt*3re record size; +30 

makes the record size much smaller, yet still allows minor changes to be 
made to the definition when tt r s back in View-Store. In this case, 
remember to add Ha If 1, Half2 and the Field list for any new lines when 
you're still in view - there won't be room to add them later. 

Alternatively, the CONVERT utility can be used to compact a report 
definition fife. Load the report definition into ViewStore: 

->LOiH A.3LDREP REPORT 

»>umm comreni? 

CONVERT 

Use sfcletX file IN,V>? N 
Field 11 * 
field 27 

New record sis* (+2Ql2 *30 
New filt rtdrtie? R.HCTREP 
CenveiXing recsjrds + . + , 

6 records processed 

Largest record was 129 byt^s 

=> 

This can reduce report definition files to less than a fifth of their original 
si££, and yet still leave a little space for minor editing of the new 
definition, called in this case r FLNEWREP\ 

Mailshot Reports 

A report definition can be quite complex. It can even include all the 
elements of a standard letter so it is possible to produce a mailshot 
without involving view at all 

Using the MEMBERS database described in Chapter 11, a report could be 
designed to print a letter inviting everyone to a regional meeting. The 
report definition might look like figure 17.6. Most of the details of this 
report should be familiar. There ere a couple of H lines to leave a space 
at the top of each page. The page length is set to 66 lines by a F line, and 
two comments are used for the date and the cost of lunch. Take care 
over the comments - although the cost is a decimal number, a pattern 
like can't be used in 1 iaifl to control the number format 
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because comments are always treated as teat. The third comment is a 
dummy, used to control the placement of highlights. 


T min .-.......list,,, 

B 
U 
H 

M 
R 
B 


f H l»l»f ! I E!i IHHf I 

e«ee i««&i m f sea (ii«ii>iifi»e 0 

fl *A 0 I HflH i 5**0 0*00 09*0 *« 0 

D a-iu |J - y *H , tv.fi Bee*. *B BB 9 S iMd** 9 f 

e $• i i««b imatee t M*l«* 


The^BBal Tamil ndufUnlii hnidlrtg * nq±m*L 
iwrft in* tfl Kaaiumb act DmrtrtC N** i.hm lankly 
Roonifl in D»C* Si,, It yna ■ : rh to flir.*wi4 . OWld 
vua lafewm th* loi* tD th* Sacntxiy 

Kir. a3 p--3*i3.>. A ctimngm cC UiBH -111 Is* 

fn-f !uiid9 And. ra/nibw^tl- 
SKntar? 


*C1 

Titl#,. 

H a,*Cl, 

-a 


fin 
*».-X3 


I hi ail to wn W tit* i*gion»l P»t.lfU U* I^LAfi an 
rise:—3t>i. 1 wtil/wMl't t*qulr* 1 uik±i »t th* 


N HltdllBilliB «9i*f4tl4lltlMlh ni«b*r f|>4 


‘FLa*-. <9iiI* p .Pi!Ur 




c - Today K # 4 k*? 

C Dur^k £de iundhlf t 
e JiH'- vc-d 
r 


Figure 17.6. Invitation report. 


When the report is printed, each of the R lines is printed for each of the 
records, so every person cm the database will get the whole letter. And 
each letter will nave their personal details inserted Into it. Of course, 
an Invitation Like this would be combined with using the SELECT utility to 
select all those people who live in the north-east region. 

Each letter is printed on a fresh page because a page eject ( A P) is set in 
the S line. Page ejects can only he put in subtotal or total lines. The next 
thing is lo ensure a subtotal gets printed at the end of every letter. This 
can be done by answering the prompts: 

Sub-total field? * 

Sub-total field? 

This means that every field used as a subtotal 'briggeri,, and so a sub* 
total is produced lor every record 
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VIEW and Multi-Macros 

The letter in figure 17,6 could just as easily bp produced using VIEW'S 
macro facility. Producing a view macro file from the records in a name 
and address database using the MACRO utility, in order to send out a 
mailshot, was covered In Chapter 11. But there can be a problem - VIEW 
is incapable of accepting more than 132 characters on a line. If Vu-W 
tries to load a file containing a line longer than this, then the text can be 
corrupted- 

fn turn, this affects the VlewStone macro utility. As this extracts fields 
of Information from a database record, it has to ensure that the fields 
don't add up to more than 132 characters. Occasionally, they will If 
this happens, the MACRO utility splits the line, and the excess characters 
t ire placed on one or more additional lines below the macro. At the end, 
it displays how many macro calls have had to be split in this way. 

The ViewStore manual suggests a remedy ■ (he list of parameters for 
the macro should he edited in view, joining the Lines up into one again. 

But with a large database containing addresses of legal or financial 
partnerships, accountants or advertising agencies, this becomes 
impractical - they all seem to have long names? 

One solution to this problem is to split a standard letter into a series of 
two or more macros. For an example, see the macro definitions in 
figure 17.7. When used together the two macros A A and AB would print 
out a complete letter, but each macro is Incomplete on its own This is a 
'multi-macro*. Unlike a standard letter produced by passing 
parameters to a single macro definition, this multi-macro example 
would need two macro calls to complete it. The two must be in the 
correct order. Of course, two macros isn't the limit, you use several in a 
single multi-macro A set of calls to print two of theletters is also givsn, 
in figure 17,8. 

) 


» 


) 


} 
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IQH M 

CZ Ball I to. Htmling fl*rric** 

VJ SO 
u is 
u u 
u u 

RK 

CH Ab 

H 

7 Nmr IlfLxrvad Ep»ci£iGalLLEri 
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Figure 17.7. Multi-macro definition in view, 

AA 5'l. E^scriictiori ! CEi£rLiiMX If. fork**- 
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,KA Jl.ft-07. IT Whin Tarcaoa.rhonvthMSiita^o. rr.irb jm 

M Attn; 

Figure 17*8 Two calb to the multi-macro in figure 17.7, 

Ait the parameters of a multi-macro can add up to more than 132 
characters, providing that any one individual macro doesn't have more 
than this number in its parameter list- So two macros with TOO 
characters-worth of parameters each is fine, but one macro with 2Q0 is 
not The other Limit on macros is that there may be only 10 parameters - 
©0 to @9, This is less often a problem, but it can abo be solved this way. 

ViewStore and Multi-Macros 

The MACRO utility can only produce a series of calls \o a single macro, 
one 1 call for each record in the database or one for each record in the 
SELECT File The program listed at the end of this chapter can produce a 
macro file containing □ series of calls to a multi-macro, which can be 
composed of several individually named macros. 

TypL’ in the BASIC program at the end of the chapter. Save it and then 
run it- The BASIC program should assemble and save a machine code file 
called 'VSMACRC7. 

There are two steps in producing a file full of multi-macro calls from a 
database using vsmaCRO First a ViewStore report definition is set up, 
describing the fields to be taken from the database and put into the 
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macro parameter lists- The report definition has a special layout that is 
described next. Then, in ViewStore Command mode, VSMJOO and the 
database are loaded, and the REPORT utility is used to *prinf a report, 
using the special report definition file, vsmacrg creates the macro file 
from the report. 

Multi-Macro Report Definitions 

The first operation is to create a blank report definition file, using the 
SETUP utility as normal. Load the new blank definition file, and switch to 
the data screen to see the blank definition. 

One report line in the definition is needed for each macro - that means 
two or more lines for a multi-macro. Obviously, the macros in the 
report definition should be in the order they are required in the multi- 
macro. There are three types of information to be entered for each 
macro - Type, Format line and Field list. 

Type must be Ft for every macro. There must be no other types of line 
except comments - no header lines, sub-totals or totals. 

The Format line, placed in the fields called Halfl and Half! as norma], 
must start with a tw r o-letter name for the macro, as used in the macro 
definitions This must be different for each macro. Immediately after 
the macro name, the @*8)©© patterns should be listed. Each pattern 
will be replaced by information from the database when the macro file is 
written. Separate the patterns with commas, not spaces. If the pattern 
may be replaced by information that might include a comma, then 
surround the format with angle brackets. These are necessary for VIEW 
to interpret the macro parameters correctly. Finally, put an extra four 
character pattern at the end. 

A complete Format line could look like this: 

T. Halfl.....,. *. *__ 

The macro AC has three parameters - the second is a number with one 
decimal place, the third may include a comma. If the information from 
the database is loo short for (he pattern, for example a six-letter 
surname in a 15-letter pattern, then the rest of the pattern is padded out 
with spaces. I f the information is too long, then the last five letters of 
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the name are Ignored. The length of each oi the macro parameters Is 
controlled explicitly by the length of the pattern. 

The Retd list must contain one item for each pattern in the Format hne, 
just as with normal reports. The item for the extra last pattern should 
be JR. 


A complete example to define a multi-macro for the standard letter in 
figure 17.7 is given in figure 17-9. Notice how a comment is used to add 
the appropriate date to the letter. The 'Alin:' and the space before the 
name iiela are added to the macro parameter explicitly, by putting them 
within Half!, rather than extracting them from the database. "Attn:' 
could just as easily be put into the VIEW macro definition. 

When the report definition file is complete, press ESCAPE to return to 
ViewStore Command mode. 


L Sp»=* 295 [ndioiKi by art 
*yyui pf— ffriw anit 3f j 'bu.'itr r Jft. ft*r*HT-c-.rd, 3-"a ut"tf-lj 2 ■ T — L i 

~ . H|(4 fl - - ■ < .... Ft iiiri--t-~. - -J.. .. 

H tjanun iF * BIIIiffl h>.* w eiis ibbe m ri. wm miH, ti« 

f i mti itimia. hmuiiii 

C tV^Uy'- 


. .... . ,-ri*l.d u*t.... .- 

'€1.3t rri-C. 7iiiw r County, l& 

Huh, BB.lutaU.itfi' IP 
Toliy t «Ut«? 


Figure 17.9. Multi-macro VkwStore report definition. 

Printing a Multi-Macro Report 

VSMACRO is a printer driver that first appeared in Aram User, 
November 1987. It can be loaded by typing: 

PRINTER VSMACRO 

In ViewS tore Command mode. This printer driver should only be used 
to 'print 1 multi-macro reports. The effects with normal reports are 
unpredictable, though the database itself won't be damaged 

The database must also be loaded, After this, run the REPORT utility in 
the normal way, and answer the prompts as follows: 
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uaa select file (K,*}? if 

screen or printer (S,F}7 P 

US£ report fboftat file (N r ¥J? If 

Report filename? MMRERT 

SencJ totals to linking file (N* t) ? 

Subtotal field? 

Single sheets CN,¥>? 

Today 1 a date? 21 Jun* 198V 
Macro filename? v. mmcalls 

This uses & report file called ■r.mmrEFT'. The last two prompts are new. 
The first of the two comes from the comment line in the report 
definition, the second simply requests the name of the file to put the 
macro calls in, in this case a file called 'v.mmcalls'. 

The information is then extracted from the database by the REPORT 
utility, and the macro calls are put into a file. One macro or multb 
macro call is produced for every record in the database or one for every 
record in the selection Hie if t he SELECT option was chosen. 

if an error occurs during this process, or ESCAPE is pressed, then the 
files are closed and the program returns to ViewStore Command mode 

Using the Macro File 

The macro file can then be loaded into VIEW for checking, or merged 
with the letter file containg the multi-macro definitions, The easiest 
way to print the whole set of letters is to enter VIEW, load the correct 
printer driver, and type: 

PRINT *L^tter <macro filena7ne> 

The letter Hie should contain only the definitions of the multi-macro 
making up the standard letter, like the file shown in figure 17,7. The 
macro file should contain the calls with parameters extracted from 
ViewStore. You could use SCREEN instead of PRINT If just a quick 
preview o£ the letters is required, 

There is an important consequence of the V5MACRO method. The macro 
parameters produced are of fixed length, the number of characters in 
each field (®fl, @1 F ©2 P and so on) is controlled, and the parameter is 
truncated or padded out with spaces as necessary. The standard macro 
utility' produces parameters that are of variable length, so a name could 
be five or 50 characters long. V5MACHO makes them the same length as 
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the relevant pattern in the repart definition. So if the macro 
parameter* in figure 17,8 had been taken from a database with 
VSMACRO, they would have looked like figure 17.10, Notice that a 
couple of the parameters have been truncated because the data taken 
from the database exceeded the pal terns In the report definition. 
Others have been padded out Notice too the extra number at the end 
of each line ■ this is taken from the IR in the report definition. 


pWl 21.6.&7 , Ngm 1«£ Cffn-sti. r Cuetuibfit Road 
ap Attire EnsUllAtiCfl KMl»g4C ,faithfully 
AA 21,6,07 * 17 rfbifi TnrriCC ,ThOCntH«it9 
ab Attn: Jea&ph Addymap , aijrearaly 


,<x&ig5bl*y, tf. ^rk> p 17 

. ^ 

f 404a Durham >, 19 

. IB 


Figure 17.10. Two VSMACRO calls to figure 17.7 multi-macro. 


Advanced Use of VSMACRO 

The padding spaces left at the end of the macro parameters can be 
removed if necessary. Load the macro file into VIEW and type; 

CHANGE/ ,/,/ 

CHANGE/ >,/>,/ 

then resave the macros. Excess spaces are recognised because I hey 
precede a comma. Neither ordinary spaces by commas within angle- 
bracketed parameters, nor the leading spaces before numeric 
parameters are removed, as these occur in their usual place, after a 
comma. This is exactly what is required to keep everything neat. 

The real function of the extra i R is to ensure this space stripping works 
property on ail current versions of VIEW. In fact, a comma and any 
single character would do ( but using IK has a side effect; all the multi- 
macros are serial-numbered (up to 9999). The number is Ignored by 
VIEW; It isn't printed and has no effect on the rest of the macro. But if 
standard letters should be serial numbered, then use this extra field - if a 
macro normally has four parameters, @0 to ©3, (hen @4 is the i>enal 
number, 

VSMACRO allows any highlights used in the field list of the report 
definition to be traikferred into the view macro file. 

Using VSMACRO offers one more facility, the ability to join two or more 
pieces of informa tion from separate database fields, to produce a single 
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macro parameter. The standard MACHO utility insists that one database 
Geld equals one macro parameter- But consider this Format line 

T.Halfi. ¥ . 

r. AD<n«0^i?e'i9@«e^meee f 

The macro AD has only one parameter (discount the extra one at the 
end for 1 Rh because VIEW will treat the two patterns enclosed by angle 
brackets together as one. The patterns will be replaced by data from 
two database fields. A job title field and a company name field could be 
joined for instance. The macro call might eventually be: 

AD <5ales FepresontaLivc, British Sine Co, >, I 

The space and the comma alter "Sales Representative" are derived 
explicitly from the Format line, like the "Attn: in the figure 17.7 
example. With joined fields like this, it is almost certainly necessary to 
remove the padding spaces, to keep the parameters neat, 
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Program Listing 17.1 

10 REM VleuSton Jiacro spa-dler source 
2C REM by Graham Beil 
30 RFM for B/B+/M/E + Vi«wStOre/VtEW 
40 REM (C? Acorn User I9&1 
50 ' 

60 brkv - *202 
70 DSfind = &FFCE 
80 03b(put tFFD4 
90 OSSset ■ *FFE3 
1QD oswOrd = fcFFFl 
HO qsbyte = frFFF* 

120 i 

130 DIM store iff 
140 FOR 11 = 0 TO iFF 
ISO rl7store = 0 

l€0 HEXT 

no offset = score - *4.00 
1B0 * 

150 FDR pass - 0 TO 2 STEP £ 

200 Pi - store 
210 i 

220 OFT pass 

230 JMF output ‘ offset 

2*0 RTS 

250 .last 

260 Bftft 

270 *char 

280 BfflK 

2 50 JMF ciose^offaet 
300 RTS 
310 .nbrfc 

320 OPT FHequwfbreak-offset) 

330 RTS 
3*0 .handle 
350 BAR 
360 2 
370 .text 

380 OPT FKequsL ,k ? eftanelif orcaM") 

390 OFT FNequw[ k 0FOD) 

400 i 

410 .osbidck 

420 OPT FMequw E f i . e t.-uin ■_■ -off se t ^ 

430 OPT FMequb E&4.FF-(filename-off seUl 
440 OPT FNfrqub(33j 
*50 OPT FNecjub(126) 

460 s 

470 .openlile 
ABO W* 1*12 
450 .message 
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500 LDA text -offset, Y 
510 JSK Dsasci 
520 DEY 

530 BPb message 
540 LDA 10 

550 LDX f (Dsblock-offaetJMOMSfi 

560 LOY t[QBblock-Qffset)DITCH 

5?0 JSR OS«Grd 

5&0 BOG naescape 

590 LDA IfiTC 

600 -JSft osbtye 

610 BRK 

620 OPT FNequbfiBO) 

630 OPT FWequi (*Esc«pa* 1 

640 BRK 

650 .noescape 

660 LDA ItfiO 

670 LDX I (fiienaJiSe~dffseUMGD25G 
600 LD¥ *[ filename-offset)P1V256 
690 45ft osfind 
700 TA¥ 

710 BKE sethandle 
750 BRK 

730 OPT FHequbHBU 

740 OPT FHequst*Can 1 t open file"j 

75 0 BRK 

760 i 

110 .close 

700 LDY handle-offset 
790 .closedll 
BOO LDA #0 
510 JSR os find 
B2D *3ethandi® 

333 STA handle-offset 

840 .vector 

850 5EX 

&60 LDA brkv 

87*0 LDX fibrk-offset 

sag sta nbrk-offset 

890 STX brkv 

900 LDA brkv+1 

910 LDX nbrX+1-offset 

920 STA nbrk +1 -offset 

930 STX brkv+l 

9*0 CLI 

950 RTS 

960 ; 

976 .break 
900 PHA 
990 TXA 
1000 PHA 
101D TYA 
1020 PHA 


2S0 


103Q LDY tQ 

1040 J5F- clo be all-offast 

L050 FLA 

1060 TAY 

1070 PLA 

ICSO TAX 

1090 FLA 

1100 (brfcvj 

1110 3 

112 Q ,output 

1130 ETA char-offset 

L140 TXA 

1130 PHA 

1160 TYA 

1110 FHA 

llBO LDY handle-offact 

1190 BHE iSdpen 

120Q LOA I40D 

1210 STA last-Offset 

1220 JSS dpenfile-offset 

1230 k 1sopen 

1240 LDA I60D 

1250 CMP last-offset 

1260 RNF nptend 

1270 CMP char-offBEt 

1250 BEQ return 

1290 LDA tfiElO 

1300 J5R osbpyt 

13X0 inotend 

1320 WA char-offset 

1330 STA last-offset 

1340 BEL print 

1350 AND #47F 

1360 BEQ btone 

1370 LDA t*01 

1380 .htPne 

1390 OPA |& 1C 

14 DO .print 

1410 J5R- asbput 

1420 BIT chat-offset 

1430 BMI return 

144 0 .1$R osasti 

1450 ,return 

1460 PLA 

1470 TAY 

1400 FLA 

1490 TAX 

L5D0 LDA char^offset 
L51Q RTS 
1520 : 

1530 T filename 
154D ] 

1550 NEXT pass 
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1560 s 

1570 sum = 0 
1580 FOR II = 0 TO &FF 
1590 sum • sum 4 It?stare 
1600 -NEXT 

1610 IF Sum c> &5O0B PRINT 1 "Checksum error - please ChedJc 
listing* 1 : END 
1620 : 

1630 PROCOSClirSAVE V 5 MACRO * 4 STflS-StOre 4 41 4100 ACC 400 *} 
1640 END 
1650 s 

1660 DEF FNequb (byte) 

1670 ?Fl - byte 
16B0 PI = F* + 1 
169D = pass 
1700 : 

1710 DEF Fh'equw (word^ 

1720 ?PI = word MOD Z5G 
5730 Pl?l - word DIV 25G 
1740 FI = P% + 2 
1750 = pass 
1760 l 

3770 DEF FNequaUtrlngSl 
1780 $pi = strings 
1700 PI - Pi + LEW strings 
1000 ■ pass 
1010 : 

1020 DEF FSOCosCli(Strings) 

1030 DIM m 5FF 
1040 Y% = X% DIV 256 
1050 $X% = strings 
1060 CALL, 4FFF7 
1070 ENDFROC 
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ViewPlot 

ViewPlot is a utility for displaying numerical data fromViewSheet or 
ViewSton? in a graphical form. The package consists of a suite of BASIC 
and machine code programs on disc, plus a function key strip Before 
starting to use ViewPlot, make .1 back-up of the ViewPlot disc. Use the 
copy and keep the original in a safe place. With a 40-track drive, the 
back-up can be made with the ^BACKUP command. An BQ-track drive 
requires the use of the *cowFtc utility on the ViewPlot disc. Align the 
key strip above the function keys. 

ViewPlot works with DFS, ADFS or the Network Filing System. On 
Econetj consult the network manager about making ViewPlot available 
on the fileserver, 

ViewPlot can be started up by auto-booting the disc using SHIFT-BREAK. 
If all is well, this displays a sixdtem menu showing the available 
options for entering data and chart plotting. Choices can be made? by 
pressing the number key associated with each option. It is best to keep 
the ViewPlot program disc in the drive, because View Plot uses a system 
of ewriflys; parts of the ViewPlot program are kept on the disc and only 
loaded in when they are needed. 

Entering Data into ViewPlot 

All data plotted with ViewPlot must be put into a ViewPlot data file first. 
This data can be typed in manually, ur it can be taken from a ViewSheet 
link file, or from a spooled ASOi file. This is done using main menu 
option one. 

The simplest way as to enter the data manually. The data editor 
presents .1 screen display showing a status area at the top, plus two 
data entry windows. The main, lower window is divided into three 
columns - Labels, X and Y The Labels (or L), column cart contain text 
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items up to 11 characters long, but the X and Y columns can contain only 
numbers. Each column is divided into rows, and the row numbers are 
displayed on the left of the screen The working of die screen display is 
similar to a spreadsheet. A cell cursor is shown, initially in cell LI, but it 
can be moved about with due cursor keys. 

To enter data into a cell, fust type it in. As it is typed, i t appears in the 
status area at the top of the screen, where there is a flashing cursor. 

Hut when RETURN is pressed, the data is transferred to the cell, and the 
ceil cursor jumps automatically to the next cell. As an item is added to 
the l. column, matching data appears in the X and Y column, This is 
initially set lo aero, but any number can be lyped into these columns, 
with any number of decimal places. However, data In the X and Y 
columns is always shown with exactly two decimal places. 

To edit an item, simply return the cell cursor lo the cell,, and retype it 
correctly. To delete it altogether and leave a blank cell, type a space 
then press RETURN. The function keys ft? and 17 can also be used to edit 
the data, ffi puls in a new blank row at the current cell rumor, allowing 
a forgotten item to be inserted, and f7 deletes the current row and 
closes the gap by moving succeeding data items up 

Function key ro controls auto-entry When it is on, 'Auto-entry' is shown 
in the status area, and pressing RETURN sends the cell cursor to the next 
cell. Switching auto-entry offleaves the cel] cursor static, and the UP, 
LEFT, RIGHT and DOWN keys need to be used to position the cell cursor, 
The cursor can also be moved to a particular row by pressing JS, then 
typing in the row number. So: 

ffl GOTO 12 

moves the cursor to cell LI2. Data can be entered on up to 100 raws, 
although on]y 15 rows are shown at any one time. 

Pressing ft pillows any star command In be used. A blank screen is 
shown, with a V prompt. For example, typing: 

fi * CAT 

shows a catalogue of the files on the disc To return to the data editor 
screen, just press RETURN. Note that using some commands, *nACKUP 
or *tOPY for example, are Ukely to corrupt the View riot program and 
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crash the computer, so ensure only 'safe' operating system commands 
are used. Unsafe commands are listed in Appendix 6ne 

The TAB key moves the cell cursor to the upper window, and a second 
press of TAB returns it to the lower window again. In the upper 
window, various text items can be typed in. This is used to annotate the 
data when the final graph is displayed. Each item can be up to 11 
characters long^ 

After the data is complete and correct. It can be saved in a ViewPJot 
data file To save the file, press 13, and type the filename at the prompt, 
in a similar manner, data files can be reloaded and edited, using 12. 

With dfs or adfs, die filename can include the drive number,, so that the 
data need not be kept on the ViewTIot program disc. To save the data 
on the disc in drive one, in a file called TX NUMBERS', type in: 

13 

File to savcil.D.NUMBERS 

Using directory U for data files is a good idea because ViewPlot also 
uses 'format files When the data has been saved, return to the menu by 
pressing ESCAPE - because this can lose any unsaved data, it must be 
confirmed with T\ 

Types of Graph 

Figure 18.1 shows a data editor screen, with each part of the display 
filled in. The same data is shown again in figures 182, 18.3 and 1^,4, but 
In I he final graph form. Any of the graphs can be produced with main 
menu option three. 

Option three produces a series of prompts to select file type of graph 

display required; 

Enter screen mad? (4 or 5] ^ 4 
Do you u Aji t default colours? 1 
DO yOU WdElt patterns? Y 
Do you want a border? Y 

Data;f■rmat file name? <data filename* 

With a micro incorporating extra shadow memory, modes 0,1 or 2 may 
also bo available. A border is simply a line remnd the edge of the screen, 
and is almost always appropriate. The data/format filename is the 
data file saved from the data editor. 
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The colour and pattern prompts refer to the use of special files 
containing screen textures that can be used to differentiate sectors of a 
pie chart for example ViewPlot has a built-in set of textures, so nu 
new special file is needed. However, View Plot has a pattern editor, 
reached from the main menu with option five, that allows new colours 
or textures to be specified and incorporated into graphs. 

Once the name of the data file is entered* ViewPlot asks which type of 
display is required: 

DO you vsnt a Bar, Line or Pie graph? 

Press B r , V or T r , and the screen clears and the desired graph is 
plotted* The three figures illustrate the Ihree types of display ViewPlot 
generates. The important point to notice is that none of the charts 
contain all the information - each displays only a part of Ihe data. Note 
also where the text is placed on each type of plot; ViewPlot allows no 
control over this, so make the best of the titles and axis labels that can 
be incorporated* 
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Figure IS, 1. Completed ViewPlot data set. 


286 


Putting on a Show 



Figure 18,2 Pie chart illustrating fig 18.1. data 
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Figure 183 Bar chart illustrating fig 181. data 
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Figure 18.4 Line graph using fig 18.1. data 


Pie charts show sectors, each labelled with the text taken from the L 
column of the data editor display. As figure 18.2 shows, the size of the 
sector is controlled by the data in the Y column, but the figures in the X 
column are ignored. The sectors are plotted in the same order as the 
rows in the data file, anti clockwise. Pie charts are most appropriate 
when the data represents proportions, and where the actual amounts 
are less important than their relative sizes. They are used most to 
illustrate data which could be turned into a set of percentages, alt 
adding up to 100, The size of each sector is worked out according to 
that row's proportion of the Y column total Row 7, labelled *G% 
represents 64 out of a Y column total of 255 - that r s about a quarter, so 
the sector is close to a quarter circle. The figure shows one problem that 
can occur with pie charts - very small sectors such as A, B and C make 
the labels overlap. 

A bar chart, or histogram * as shown in figure 183, also uses the text 
from the L column, at the base of the bars. The height of the bars is 
controlled by the Y column data, and again the X data is ignored- The 
bars are drawn in row order, and each is labelled at its base. View'PIot 
makes an intelligent choice about the total height of the Y axis,, 
searching for the largest item in the Y column. It also automatically 
marks the round numbers along the axis. The width of the bars limits 
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the length of the labels - in the example, only four characters could be 
displayed at the base of each bar, With more than eight rows of data, 
there would be narrower bars,, so the labels would have to be shorter. 
Uar charts are useful for many types of data, particularly where it is 
aggregated into groups of equal importance or where non-numerical 
comparisons are being madia - each bar could be a monthly total labelled 
JAN-DEC or could illustrate journey miles on different types of 
transport, for example. 

The 1/nf graph in figure IB.4 shows points linked by straight lines. This 
is the oniy type of plot that takes notice of both the X and Y columns of 
ihe data, though the text in the L column is completely ignored in the 
line graph. The exact position of each of the points is controlled by the 
X and Y data- In the usual Cartesian maimer, X gives the position left 
to right along lhe x-axis, and Y gives the height of the point up the y- 
axis. The points are linked by lines in the row order they occur in the 
data file. As with the histogram ViewPlot makes automatic choices 
about the length, subdivision and labelling of the axes. Line graphs like 
this are usually used Eo show how one numerical quantity depends upon 
another, say how the quoted cost of a component depends upon the 
order size - order more and the cost of each one falls. 

It s important to control figures 18.3 and 18.4, which apparently show 
contradictory trends in the same data. This arises because the bars in 
figure 18.3 are plotted in row order, and the low-numbered rows have 
low Y values - remember the X values are ignored. The low X values in 
figure 10.4 are associated with high Y values, and high X values with 
low Y values. So it is important to work out what the Y values are 
being plotted against. Do they depend on the row r or are the X values 
important? 

Because each chart needs only some of the data, parts of the data can 
safely be left blank. There is no need to fill In the L column of the data if 
only a line graph is to be plotted. 

ViewPlot and Printers 

ViewPlot charts can be printed out by pressing SCREEN' print (function 
key f9), after the chart has been displayed on screen. However, the 
screen print program works only on tpson FX-compatible printers, and 
only If they are set to give automatic line feeds. Luckily, there is also a 
fadfity to save the screen to disc. Key f0 is labelled SCREEN DUMP on the 
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function key ship, but in fact it puts the screen display into a file on disc 
called image-:. This ran be reloaded later using the *LOAEMJMF utility on 
the ViewPlot disc. If a screen print program is available for the 
attached printer,, or if there as a ROM-based screen print utility such as 
Acorn User's UserDump fitted, then the following basic program can be 
used to reload the saved screen and print it: 

Id REM reload and print screen 
20 ; 

30 *L0MKJMF tHfsGB 
40 *SDUMP 

This assumes that the screen print program or command is called 
*SDUMP; if the command is different from *SDUMP, or if extra 
parameters are needed, then the program can be amended. The 
important point is that *1 jo A POM? reloads the screen and restores the 
mode and colours that were in use when the screen display were saved. 

An alternative way of doing the same thing Ls to put a new file nmxJM? 
on the ViewPlot disc. Most existing screen print programs use a section 
Of memory that does not conflict with ViewPlot, often at &9Q0 - a 
selection of such programs have been published in Ac&ni User 
magazine, for example in the September 19®6 and May J9®7 issues. If a 
program known to work with the printer is put on the disc and called 
TRTDUMP, then ViewPlot will use this automatically Remember to 
♦rename the old Trtoump' to something else, perhaps 'olddumf' 
before copying the new program onto the disc. 

Many printed Screens show circles as ellipses. Search for a proportio¬ 
nal dump program. This Ls a screen printing program tha t makes sure 
that circles on screen, such as pie charts, really do print as circles! 

Automatic Data Entry 

ViewPlot can be used manually, but H is more sensible to use it to display 
numerical data taken from either VieWSheet or ViewStore. ViewPlot 
can read VlewSheet link files or ordinary ASCII text files. Remember 
that ViewStore can create link files loo, using the i.riVK utility. 

The procedure to read from a link Hie is probably the simplest. 

Graphing consolidated data is the usual need for View Plot, perhaps so 
the chart can be inserted into a report document. Chapter 15 described 
a link file v,VS9 used to consolidate results from several independent 


29D 


( 


Pott jpg on a Show 


work groups in a school project This file has four columns, and as 
many rows as there are groups. Each group's results are written into 
the link file, using one row for each of the different groups Only two 
results are taken from each group, and are put in the first two of the 
four columns. The following procedure reads the results in column two 
straight into ViewFlot-. 

14 

Link file: V.VS3 

The flit is 4 columns by 0 rows 

Do you Irtish to reed a column nr a raw? 

Enter (C/R) C 

WLich column do you wi3h to read fcocn? 

Enter nUfflber {1-4) 2 

Start row 

Enter luunber Il-B) 1 

Finish row 

Enter numbe r f L—s j § 

Do you wish to read this es X or ¥ data? 

Enter (X/Y) Y 

The second column of the link file, in this case containing I he co-efficient 
of variation of the pebble sizes measured by the group, is read into the Y 
coinmii of the data editor, In a similar way, the average pebble sizes 
from column one of the link file can be read into the X column. Save the 
ViewFlot data file in the normal way, and it can then be used to 
construct graphs. 

By varying the link file row r or column number, and the start and stop 
column or row, any part of the link file can be read into the ViewFlot. 

But note that the first data read is always put into row one of the data 
editor, If more than one part of the link file has to be read into the X 
column say, then the second lot will overwrite the first:. The technique 
here is to read the second lot Into the data editor first, then use 16 to 
insert enough blank lines above it to leave room for the first lot of data 

To draw graphs of data where a Link file does not already exist is fairly 
simple. Some where in a model, there is usually an area where the 
'results' are calculated. For example, this may be a row where the sums 
of various columns are totalled. These results have to be written to a 
Link file. The way to do this is to create a mstp of the link file on the 
spreadsheet. Figure 185 shows a typical map. The idea is to duplicate 
the results area of the model, and write it to the Mnk file, The formula in 
cell D16, shown means that the contents of Cell Dll should be written to 
Ole V.VS4, The co-ordinates within the File used to store this result is 
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dictated by the 'R0W-A14 4 GOi.-A1 5 f part of the formula, and In this case 
equates to link file cell (23). A14 and A15 contain the formulae ROW and 
COL respectively. Of course, the map formulae all refer to matching 
Cells in the results area of the model and can be set up fairly easily using 
replication. 

LA 

14, lam(-Ai 4 r £tiL-Al 5, DIIJ 

+ mm.** .. A . .MM, . 

■ -.. - - s gfoupl giaup? gjoofO pwp* 

__10 nnki 41 T» i* 27 

--.*,11 ™4tz » t4 *4 ZZ 

.....IS multJ » Tt AM 11 

_14 It 

--.*-!i J. 41 Ti _. M z) 

....,11 14 li 

-,„H 3 % rr is at 

Figure 18,5. Model with a 'map' to create hnk hie 

Figure 133 also shows that it is sometimes necessary to transpose rows 
and columns in a map. Cell DIG is in the third column and second row 
of the map, and yet its result is put in column 2, row 3 of (he link fiJe- 

This transposition is needed because the results for each group lie 
within a column - grouped results within View Plot must he along a 
row. Within the data editor, the final results may look like this: 


LABELS 

X 

Sf 

group! 

41 

3& 

group2 

70 

74 

group! 

65 

64 

group* 

27 

22 


Note that only columns one and two have been read into the editor, and 
that (he labels have been added by hand Transposition can be done by 
careful answering of the prompts presented while reading the link file 
into the editor. It is a good idea to jot down beforehand the way the 
data should finally look. Even a rough note can help to show when a 
mistake has been made. 

To read a spooled text File is equally straightforward; press *5, then type 
the name of the file to read. ViewFlnt then asks for the data format that 
describes the way that the data laid out in the text file, and how it 
should be read into the ViewPlot data editor: 
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1 column of data - read into L column 

X column 
Y column 

2 columns of data - read into L and X 

Land Y 
Xand Y 

3 columns of data ■ read info L, X, Y 


4 

2 

] 

fi 

5 
3 
7 


Just press the number corresponding to the data format required, Easyf 
It is producing the text file that is a little bit more difficult, but VlewPlot 
supplies a utility program called ^PREPARE to automate part of the 
process of text file creation. The general procedure is to set a printer 
window around the area of the ViewSheet model to be transferred to 
View Plot. Altering the printer windows is described in Chapters Four 
and Five, The window should enclose either one, two or three columns 
of data, and can be up to 100 rows deep, The top and side margins 
should be switched off with the T and £ options, for example like this: 


WA TopL fretR Cm &w Fnit Opt 

P0 C4 E16 7 7 01KH TS 

It is also worth checking that the format gives sufficient precision, and 
(he column width Is wide enough to display the numbers and and labels 
correctly. Finally, make sure negative numbers are not shown 
surrounded, by brackets, and switch any other printer windows off bv 
using the O option. To use iPREPARE, set up the printer window and 
return to Command mode, then ty pe: 

■prepare 

This automatically spools a special text version of part of the model 
into a file. This spooled file can then be read into ViewPlot using f5, In 
principle, other text-only files can be read too. For example, text could 
be prepared or edited in view, then read into ViewHot, of report files 
from ViewStore could be spooled using (hq AStlT printer driver 
described in Chapter Six. Text could even be taken from more than one 
ViewSheel printer window, providing they are set up correctly. 

I lowever, because of the way the data editor reads the file, there are a 
couple of caveats! First, there can't be any spaces within a colu mn, so 
labels cannot consist of more than one word. A space signals the start 
of the next column, so it would cause the rest of that row to be 
misinterpreted, tf a label with more than one word must be included, 
then it is best to link the words with underline characters rather than 
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spaces. Second, ViewPIot can t read ordinary text files properly 
because it ignores the first and last lines of the text file, antialso the first 
character of each line, This doesn't affect •PKEpARt, because it sets the 
fir^t line to =>£C' and the last to d ->*SPOOL', and each line Is prefaced 
by a space. To make the ViewPIot data editor belter able to read 
ordinary text files prepared in view, or spooled output from other 
programs, enter BASIC, and insert a copy of the View Plot disc. 

Load the program 'V-E r , and type in the following changes: 

3250 XFSOr#*lG0TO3390 

3340 FPQCC: T%^I*4 I ;ONTTMI %> 1I OREOFl3* 

_i=D:EWDFROC 
■RENAME V E OLDV E 
SAVE _J5* 

Before renaming 'V_ _ E\ the file may have to be unlocked with the 
♦ACCESS command. 

The new version of the data editor should be capable of reading almost 
all text files properly, except those made using ^prepare. Creating 
normal text file versions of spreadsheets for the modified data editor is 
similar to using *frepare. Set up the printer window as before, load 
(be ASCII printer driver, and use the rRiiXT command- Carefully 
designed ViewSlore reports could be read in, if a text file version w as 
previously produced with the ascii driver. 

Multiple Data Sets 

ViewPIot has a facility for displaying more than one graph on the screen 
at the samp time, and also is able to plot more than one set of figures on 
the same graph, This is done via the main menu option two. Select 
Charts'- The sets of data must first be saved in separate data files using 
the data editor, option one. 

The format editor presents a three window display as shown in figure 
IS 6 - a window to specify which data files should be plotted, a window 
to put titles for the charts in, and a third window specifying a 'chain 
file* This last allows a series of format fdes to be set up, which can then 
be used in a carousel display, 

The display moves on to the next format fib in the chain when the space 
bar is pressed. 
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Figure 1&6, Format editor screen. 

The format editor works in much the same way as the data editor; the 
cursor keys can be used to move around each window, and TAB switches 
between Windows. 

In the main window, the names of any data files should be specified. In 
this case, two sets of data are being used. The numbered columns can 
be used to say what type of graph is to be plotted with each data set- 
The number of useable columns can be changed with the NUMBER OF 
CHARTS function - press SHIFMS and it changes to two, then to four, 
then returns Lo one In each column, type B r for a b lit chart, "L/ for a 
hue graph, or T for a pie charl. A single data set can be plotted on 
more than one of the charts if necessary, as shown in the figure. The 
format requests two charts, the first a histogram, the second a line 
graph, each showing both the data sets. Figure 1B-7 shows this chart 
plotted in mode 0. 1 lowever, the format could easily be set so that the 
two data sets were compared on separate line graphs, for example: 

Data secs 1 2 

t D k DATA U 

2 EKt>am2 l 

It is possible to have one, two or four charts plotted on the some screen. 
Each can display up to ID datasets, except for pie charts which show 
only one data set Labels for axes are taken from the first set of data for 
each chart, and the axes are intelligently labelled according to the 
widest range of values in any of the data sets. 
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Figure 18,7. Multiple chart using figure 1$,6, farmat 


ViewChart 

ViewFlot hits n rival: Acorn User's View-Chart package. In most 
respects, ViewChart and ViewHot are very similar - the types of graphs 
they produce can be used interchangeably in most circumstances. 
However, there are differences in approach between the packages, so 
one may be more suited to a particular application than the other. 

ViewPbt offers both pattern; and colour on screen. On a standard me 
model 0 micro, it can be used in mode 5 r and graphs can be displayed in 
four colours. Alternatively, differing patterns and textures can be used 
to differentiate parts of a chart even in a two-colour mode (mode 4 on a 
model B). View Plot only uses the high-resolution screen modes with a 
BBC B+, a 6502 second processor or with a Master series micro. In 
contrast, ViewChart always uses mode 0, even on a standard model B. 
This means that there are no colours on the sawn, but it does allow the 
graphs to be drawn with the maximum detail. 

ViewChart only allows one bar or line graph to be drawn on screen, 
whereas View Plot can display up to four different graphs at once. For 
this reason, ViewFlot is better at showing variation among data sets 
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However, the labelling of charts is much more flexible in ViewOwt - 
!ext can be placed anywhere on screen, whereas ViewPlot dictates 
automatically how and where to label axes and graphs. 

Overall, this boils down to a choice VIewChurt aims at producing the 
best printed output, even on a model B. ViewPlot offers attractive, 
coloured screen displays, but can only produce high-resolution printed 
graphs with a B+ or Master series micro, or a 6502 second processor 

ViewChart is limited to only 25 bars In a bar chart, or 40 points in a line 
graph, Fios may have only five sectors, although there may be up to five 
pies on a single screen. These are more severe limitations than the 100 
data values that ViewPlot can use, but are inevitable given the memory 
constraints of working in mode E), 

ViewChart can use data typed in by hand, and like ViewPlot, it ran read 
VicwSheet link files. These can easily be created using a map of the 
results area of the model. ViewChart cannot, however, read spooled 
text files. In recompense, it can read data directly from VTEW or 
ViewSton? macro hies; this allows text labels as well as numbers to be 
read in. In VIEW, the macros should be of the form: 

f i_*.. 

XX tent label, 12 

The text and number correspond logically to the U and Y columns of the 
View Plot data editor. In fact, up to five numbers can follow' tho label, 
and in this way ViewChart can keep multiple data sets in one file rather 
than using separate data files plus a format file as ViewPlot does. 
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The main OverView software is supplied in a single cartridge for the 
Master 128 containing ViewSlore, ViewSpelL and the extra OverView 
utilities such as the wide screen system, and *1JELP information on the 
whole VIEW family. A supplementary ADR*-fGrmat 5,25-Lnch disc 
contains the ViewXndex and Vie wPIot software, as well as the 
ViewStore utilities plus VicwSpell dictionary. In order to install 
OverView, make sure the computer is switched off, then insert the 
cartridge into the slot behind the numeric keypad on the Master 128. 
Now switch on the computer. Typing +KOM5 should show View Store 
and ViewSpeU occupying either positions zero and one or alternatively 
two and three, depending which cartridge slot the OverView cartridge 
is in It's best to make a back-up of the OverView disc to use and keep 
the original in a safe place, 

OverView is also available tor the Master Compact as part of the 
Compact Professional package. Tills version also includes ViewSheel 
All the software is supplied on a single ADFS 3.25-inch disc, and 
ViewStore, ViewShect and VicwSpell can be loaded into the computers 
sideways RAM banks. Again, don't use the original disc, make a back¬ 
up, and keep the original safe. 

Using OverView 

In use, the OverView versions of the VIEW family software are identical 
to the original versions in most respects. The only differences to be 
aware of are that the OverView disc is in ADFS format, and it Is probably 
best if ADf5 is used throughout, This means that when using 
ViewStore, the filename prefixes can be longer. For example, the 
utilities are on the disc in directory Either select the stOkt' 

directory with: 

*OIJi fr.SfOAE 
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or set up the prefix to take the directory structure into account: 
prefix u :0.*,STORE, 

Other directories on the disc are called '&SFELL', '&.FLCTT, % .index' and 
PPC'. Like VicwStorc, ViewSpell allows prefixes,, hut for the other 
applications use *nm to select the correct directory as above. On a 
working copy of the OverView disc a series of EXEC files can be set up m 
a library to automatically select the light directory and run each 
application. For example: 

> *CE>3R 4.-LIBBABY 
>*&UILD £.LIB*.PPG 

1 *pm fi.POG 

2 *BASIC 

3 C BUR 'PDHSEH’ f 

4 ESCAPE 

builds a command file called FDG. Typing *FDC has the same effect of 
*EXPC PDG. The commands will be obeyed as If they had been typed by 
hand to run the Printer Driver Generator, In this way, swapping 
between applications is much more convenient- 


The Keeper 

This OverView utility is meant to help you switch between view, 
VtewSheeL ViewS tore and ViewSpell. To see how it works, first make 
sure there is a directory on the current disc called '£c.+ r , Try: 

•DIP. 

•CAT + 

and if a 'Not found' error message occurs, then type in: 

*CDIR + 

to create the Keeper directory, Switch the Keeper utility on with the 
following command: 

•keep ON *, + , 

Now enter one of the VIEW family applications, say ViewSheet in the 
normal manner. Notice that Ihe disc drive whirrs briefly as ViewSheel 
starts up. Create a small spreadsheet, perhaps even set up a couple of 
windows, then press ESCAPE- Don't save the model, but switch 
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immediately to another application, say VIEW Again the disc drive witl 
whirr. Write a little letter, then go back to ViewSheel Again there 
should be a pause while the disc drive whirrs. This time, ViewSheel will 
be restored to the exact point where you left off, with the spreadsheet in 
memory. At this point, cheek the disc: 

•c*t *.+ 

There should be six files as follows: 

AYIEVY AShrcL BVIEW 

BShcet CVIEW CShpei 

These files contain the VIEW and YiewSheet contexts; that is the state of 
the micro when VIEW or ViewSheel were last left. So the three view 
files contain all the necessary Information to allow the Keeper to pick up 
the threads of the demonstration letter written before returning to 
ViewSheel It used the three Sheet files to restore the demonstration 
model when ViewSheel was re-entered. 

The Keeper will save 12 files in total, three for each of the major view 
family applications. So there is no need to save and then reload all 
work repeatedly when swapping between members of the family. The 
keeper will even save the current work when leaving the family 
altogether, say on typing *basec. The latest context is restored when a 
family application is next started up. 

The Keeper always stores its context files in the ■'&.+' directory. Of 
course, the + directory was created specially for the Keeper. If *um is 
used to select any other directory, then the keeper will always be able to 
find the right directory, because the prefix &*+ includes & to specify that 
the + directory is only one level away from the root directory , A 
different prefix can be added to the filenames used by the Keeper by 
using Ihe command: 

*KEETr ON tC. 

when switching on the Keeper, For example, the prefix '& C/ ensures 
that Ihe keeper will always use the &:.C J directory. In a system with 
two disc drives, the drive number can be part of me prefix too. 


SDO 


OverView 


The Keeper doesn't end the necessity to ^ VL> all finished work. It keeps 
only the current document or model In VIEW or ViewSheet, when a 
piece of work is completed, it should still be saved in the usual manner. 

Before switching off the micro, make sure that you save the current 
document or model. If necessary, the current context can be saved too, 
by switching to another application Immediately before switching off: 
for example, switch to BASIC. Switching on the next time, the old 
context can be restored by starting whatever vtew application was 
being used before switching off. 

Advanced Use of the Keeper 

With a Master 128 instead of keeping context files on disc, the Keeper 
can store them temporarily in sideways RAM. There are normally four 
banks of sideways RAM available in a Master 128, sufficient to store two 
sets of context files. Keeping contexts in sideways RAM is much quicker 
than keeping them on disc, and switching between VIEW applications 
doesn't involve any disc access. The Keeper will automatically stone the 
first two sets of files in Ram, if it is activated by entering: 

*KEE£ RAW *.+, 

Any subsequent contexts will be stored on disc as usual, using the prefix 
if one is specs fied^ It's vital with contexts in RAM that the command: 

OFF 

is used before switching the computer off. This transfers any contexts 
held in RAM to disc, so they are not lost- Data can't be kept in sideways 
ram when the computer is switched off. 

A Master Compact (except the Compact Professional) can't use 
sideways RAM with the Keeper, because some of the four RAM banks are 
used to store the ViewSheet, VlewStore and ViewSpell RDM images 
themselves. 

Similarly with the Master 126, *keep ram should not be used if any ROM 
images have been loaded with the +Srload command, or if the 
sideways ram is being used to store data, or if the interna] hardware 
links L18 or L19 are set to allow poms to be plugged into the first and 
third sideways RDM sockets behind tho cartridge slots. 
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If no prefix is specified in the *reef command, then the Keeper normally 
uses the V directory, but this is of I it Me use. if *dtk is used to change 
directories away from the root directory $ (or then the Keeper won't 
find the V director}'. It is always best to specify that V is a sud- 
dineetory of the root directory. However, the '+' can be changed if 
necessary, as it Is part of the prefix. In contrast, data files in ViewStore 
arc kept in directory 'DA A prefix like 'STORE.' means they are kept in 
directory Vore The D is not part of the prefix, and is always added 
on at the end, The current Keeper prefix can always be seen by typing 
the following; 

•KEEP 

A problem occurs with the Keeper on a Master Turbo. Very long VIEW 
documents can be too long to keep. If there more than about 4300 words 
in a document, then a Too much to keep' error message may be 
displayed, In this case, save the text as normal using the SAVE 
command- It will have to be loaded again by hand when it is needed 
next. The Keeper prevents exit from an application until a context is 
saved successfully, so when the text is saved, the command: 

"KEEP QUIET 

should be used to switch the Keeper off. To enter another view family 
application and restore the context, on no account must it be entered 
directly. First, switch to BASEC with #BASIC, then re-enable the Keeper 
with * KEEP ON or *KEEP RAM, then use frSTOREv +5HEET OF *5PELL, 

Remember con texts $aved while u.sing a Master Turbo can't be reused 
without it. The exact hardware m use makes each context unique - even 
changing ROM can make old context files unusable. 

The Wide Screen 

The +WJDE command can be used to increase the number of characters 
across the screen in any two-colour mode. It allows 10b characters in 
modes 0 and 3, or 53 in modes 4 or 6. ft also works m expected in 
shadow modes 128, 131,132 and 134, but not many of the four or 16 
colour modes. Fifty-three characters is a useful width for 
wordprocessing on a television, as 80-column text can be too indistinct 
to read easily. A good monochrome monitor is essential for 106-column 
modes - or example with large ViewSheet spreadsheets. 
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*W1DE OJM switches the wide screen on, though it doesn t take effect 
until the next mode change. Conversely, *W!DF OFF switches it off at 
the next mode change AH the VIEW family make use of the wide screen 
if it is on - for example ViewStore displays the first 105 characters of 
each record across me screen in mode. 

The wide screen does make displaying text more sluggish Scrolling 
through a VIEW document or across a ViewSheel spreadsheet becomes 
noticeably slower than normal. 

Reading Contents Files 

The two OverView utilities *READ and *HC # allow text to be read into 
ViewSheet *reals is for reading formatted test from VIEW or possibly 
other applications. +RC is for reading contents files,, for reading part of 
one ViewSheet model into another. 

A contents file is created Like this. After loading the model into 
ViewSheeb type the follow ing commands' 

PRINTER ASCII 
PC 

This makes use of the ASCII printer driver described in Chapter Six. 
Alternatively, the vsxfer version could be used- The fc command is 
described in Chapter 13, As the contents file is created, the computer 
prompts tor a name to call the file, say d CQNTA F . This contents me is 
purely text; it can be loaded into VIEW, as shown in figure 19. L 


T4 12 
J4 14 
B6 11,1 

BG- WEHACEI BEE] L 41 
EE Dii'2 

<ifi II" (PS l ^*3, ST >2-4 <Gi. 1 . tl] , ClJ 
HE Ur , IF 4MOM .1.01,0] 

Ti Tr^&E^ia,. If <K<H, 1,51,01 

EiT 12.3 

E? D-y-2 

m rr iBr—ui, ip hbkih . i . o i . g i 
n STip75-I2.IFfBT^I<,l.(lJ>01 
J? ir^B7>^J2,irIS7CJI.1.qI, c | 

Figure 19.1. Contenls fife fmm the BEACH model in view. 
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An equivalent contents file, 'COISTTF, can be created like this: 

•rx s o 

•SPOOL COHTB 

PC 

•SPOOL 

*FX 5 1 

The +fx 5 commands prevent the ptr command actually priming all the 
cell contents from the spreadsheet. For serial or network printers, 

*TX 52 or *FX 5,4 should be used. tSPOOL cgntb ensures that the 
contents information is recorded in the file. The only difference between 
the two methods is that the CCMAcontains only the contents, and it can 
be loaded into VIEW with the LOAD command. CONT9 contains 
additional text tin fact =>FC RETURN' and *=>*5 puol RETURN"), plus a few 
control codes. These control codes mean it can only be loaded into view 
using the read command. 

The *RC command can be used to mad either type of contents file into 
another spreadsheet. For example, it's useful to copy a block of data 
from one sheet to another. This might happen if then? is one set of data 
and two separate ways of analysing it Type the data on to a mask for 
the first analysis, then copy it into the second mask file- 

start off by loading the first model from which information is to be 
taken. Tf only part of the model is to be transferred, then delete all the 
other cells by replicating blank cells over the unwanted areas. This 
ensures that any cell references remain correct within the transferred 
area- Nest, make a contents file. Now load the second spreadsheet, 
and ensure that there is a blank area into which the contents file can be 
read. Clearly, if data comes from cell G6 on the first model, it will be 
read into cell G6 on the new model. Any existing data in cell Gb will be 
lost. Thu INSERT ROW and INSERT COLUMN functions can be used to 
create space if necessary. When there is a dear area for the data, m 
ViewSheet Command mode, type in: 

•frC <filename> 

giving the name of the contents file. 

Of county PC and +RC do not transfer attributes like the number format 
of a cell, so the transferred data may not immediately look like that in 
the original model The process is much quicker if recalculation is set to 
manual (using function key SHiFT-iQh before using the *RC command. 
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Reading Text 

OverView's *KEAD command allows plain text to be read into a 
spreadsheet. For example, look at figure 19.2 - t his shows some text in 
view. This shows some text in VIEW, formatted so that tah characters 
separate each of the columns This text should be saved in the usual 
way, using either the save or WRITE commands. There should he no edit 
commands or rulers splitting up the text. 

F I.. 

ImLM 

.TPlil FEE rih/4 AFP w,‘c 

l 2 A I * 

t T » 1ft 

U If Id U 15 


Figure 19.2. Formatted VIEW text for transfer to ViewSheot- 

Gnce the text is in a file, it can be transferred to ViewSheet. Start 
ViswSheet up as normal and if the text is to be added to an existing 
model load that too. As with the *RC command!, ensure that there is a 
blank space on the spreadsheet to place the text, otherwise existing data 
will get overwritten. Switch recalculation mode to manual (key 
SHIFT-10 from the Sheet screen) to speed up reading. 

From VitiwSheet Command mode, to read a text file, enter; 

+ READ < l&fiams> <Q*11> T 

giving the name of the text file to read. The cell reference specifies 
where on the model the text should be placed. If the file in figure 192 is 
called 'MODLTEX', then figure 193 shows the effect of the command; 

*REXO WOCLTEX C2 T 

Notice that each column of the text is placed in a separate cell tab 
characters in the text separate cells in the model and the two adjacent 
TABS after T create a blank cell on the sheet. Each line of the text is 
placed on a separate row of the sheet too. The first line begins at the 
correct cell C2, and each new row begins below this. 

Another important point is that the text 'Stock levels' contains a SPACE 
character, not a tab, so it is all placed in a single cell. Spaces are not 
taken as separating items in the text. This could be changed, using the 
fol lowing command: 
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♦READ HQDLTEX C2 

as before, but without the final X. This would place the text ‘Stock' in 
C2 and 'levels' in cell D2, as either TAS or a SPACE would be taken as 
separating cells. But although two tab characters can be used to create 
a blank cell, two space characters don't. A group of spaces has the same 
effect as a single space* 

SUSt-G® 


0 

-1 

.3 


, . I • . . D 
* + + ►«»• 

Figure 193. Text file after transfer to ViewSheeb 

*kead is invaluable for traasferring any data that may be regularly 
updated into a spreadsheet For example, updating the price list in the 
FNVGTCT model described in Chapter 15 is much simpler using view. The 
completed list, which is shown in ViewShcet in figure 15 4, may then be 
read into the model at the correct location using *rf.ad. It is not useful 
transferring any material containing a cell reference, as this will 
doubtless be wrong if it is read to a different location on the model. 

Abbreviated Help 

OverView contains terse +HELP t£xt for all four main VIEW family 
utilities- This can be seen by typing: 

SPELL 

for example. The text for ViewSheet and ViewStore is shown in figure 
19.4, modified so that upper case letters indicate the minimum 
abbreviation for each command. Most commands can be abbreviated, 
and abbrevialions shouldn't be followed by a dot. 
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OverView 


VifltfShrtt 


ViHwStdFit 


Create n x y 
Headings on /off 
Load file 
LVf file 
Mode n 
HAfni> (file) 

NEW 

PC 

Print 


LF file 
List 

Load file 
Mode n 
NEW 

PR£fi?i tLetter (string)! 
FJUNTEr file 
SF file 
Utility file 


PftIMTEr (file) 
PFOtect nn/fcff 
*RC file 

•READ file Slot (T) 
Save (file) 

SCreen 
sw file 


Figure 19 4 Summary of VkwSheet and ViewStore commands. 
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Appendix A 

ViewSheet Quick Reference 


VievvSheet Command Mode 



The following commands can he used in ViewSheet Conimand mode. 
Minimum abbreviations are shown in brackets - either capitals or lower 
case can be used. 


CREATE cn> <x> <y> 

ESCAPE 

HEADINGS [ONjOFFJ 

LOAD <filename> 

LW <fi]ename> 

MODE <n> 

NAME <filename> 


Creates a blank link file called v V5n (for 
example V VS17), n must be between one 
and 255. The file has x columns and y 
rows. See also the READ and WRITE 
functions. (Q, 

Switches to Sheet mode. From Sheet 
mode, ESCAPE returns to Command mode. 

Row headings and column headings can be 
switched on or off. Current heading status 
is shown with just HEADINGS* (H). 

Loads the model file, including the printer 
and screen window definitions saved with 
the model. The file must have been saved 
with the save command. (L)* 

Loads the window file. The file must have 
been saved with thesw command. 

Changes the screen display to mode n. Any 
screen window definitions are lost, but 
printer windows are retained. (M), 

Sets the default filename, which can then 
housed with the SAVE command. (NA). 


*AV-L- 
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NEW 

Clears the model and window definitions 
from memory, leaving a blank sheet. 

Then? is no old command 

PC 

Frink the name of each occupied cell 
together with its contents. Useful only for 
debugging a mi>del p or in creating a 
contents file for OverView. 

PRINT 

Prints the model using any printer 
window definitions if they are set (P), 

PRINTER <filenaitie> 

Loads a VIEW family printer driver, The 
driver is used with the pc and print 
commands. Individual printer windows 
can be printed using underline and bold 
effects. (PR1NTE). 

PROTECT EON,OFT} 

PROTECT disables or re-cnables the 
protection preventing rows and columns 
being deleted or altered, (PRO). 

SAVE <fiiename> 

Saves the model and window definitions in 
the specified file If no filename is given, 
then the default name set with the NAME 
command is used. (5), 

SCREEN 

Displays the model on screen, using the 
printer windows. Useful for previewing a 
model before printing. (50. 

SW -cfilename* 

Saves the printer and screen window 
definitions in the file. 

sfcSHEET 

Selects and loads ViewShnet from another 


application. 

Ail other star commands can be used too, though some may corrupt the 
model in memory. These dangerous commands indude: ♦BACKUP, 
*COMFACT, *COf% *SDKMAT, *1,0AD, 4&KUQAP Cubing Q) and ♦SRSAVli 
(using Q) Other star commands like *has]C and *wGTCDalso lew the 
model in memory because they select another application. 
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ViewSheet Sheet Mode 


The following functions can be used in ViewSheet Sheet mode. The 
values n and a represent expressions, which can themselves contain 
other functions, cell references and the like, as well as constants. 


ABS <n) 

The absolute value of n. abs (n) is alw ays 
positive, even il n is negative 

ACS (n> 

Arc-cosine. Gives the angle of which n is 
the cosine, in radians. 

ASN (n» 

Arcsine. Returns the angle in radians of 
which n is the sine. 


The arctangent of n gives the angle of 
which n is the tangent. 

Gives the mean (average) value in the list. 
List Items may he constants, cell 
references, ranges of cells or other 
functions, separated by commas. A range 
is taken as several separate cells, and 
blank cells am counted as zero values in 
averaging. 

Chooses the nth value in the list. The list 
may contain constants, cell references or 
other functions A range in the list such as 
B5B8 is taken as a single item, the sum of 
the four cells, not as tour separate items, 
CHOOSE is only useful when n is a cell 
reference. 

COL The number of the current column. 

Column A is 1, column Z is 26, column IU is 
255. 


ATN in) 
AVERAGE flist) 

CHOOSE <n,Hst) 


COS (a) 


The cosine of a. Angle a must be In 
radians. 
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DEG (a) 

EXP tn) 

IF kt>ndcmU,ouf23 

l NT (it) 

LN in) 

LOG (n) 

LOOKUP (n^rr) 

MAX (list! 

MIN Gist) 

PI 

RAD tal 


Converts angle a from radians to degrees. 

Exponent of n. Exp is the inverse of i.Nf; it 
converts from a natural logarithm back to 
a normal number. 

ef returns the value of outcome 1 when the 
condition is true, otherwise it returns 
outcomes. The condition can he an 
estpresson like ' ASM O', or an ordinary 
number. ViewSheet takes the number zero 
to be FALSE, all other numbers to be TRUE. 

IP can be nested to simulate AMD and OIL 

The whole number part of n. 

Gives the natural (base e) logarithm of n. 
See EXP. 

Gives the ordinary (base ID) logarithm of 
n. There is no anti-log function; the 
function iO A n should be used 

Searches the compare range (cr) for the 
value n. When n is found, LOOKUP returns 
the matching value in the result range (nr). 
Used for things like price lists and looking 
up values in tables. 

The highest value in the list. The list may 
bo made up of constants, ceiS references, 
other functions or ranges, separated by 
commas. A range is taken as separate 
cells, not as the sum of the range. 

The lowest value of the items in the list as 
with max. 

3.141596253 in) 

Converts the angle from degrees to 
radians. 'CO& (RAD (45))' is the cosine of 45 
degrees - remember ViewSheet 
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trigonometry functions require aP angles 
in radians. 

READ (n^,y) 


Reads the value from column x, tow y of 
the Link file v vsn. See white. 

ROW 


The number of the current row 

SCN <n) 


gives zero if n is zero, one if n is positive, 
and minus one if n is negative. 

SIN (a) 


The sine of the angle a (in radians). 

SQR <n) 


Square root of n (n must be positive). 

TAN (a) 


Tangent of a. The angle must be in 
radians. 

WRITE (n,*,y, 2 > 

Writes the value z to the link file v vSn. in 
column x, row y. 

The following mathematical and conditional operators can be used in 
expressions or conditions. They are listed in order of their precedence: 

group 1 

-,o 

unary minus, brackets 

group 2 

A 

power 

group 3 

/ 

multiply, divide 

group 4 

+, “ 

add, subtract 

group 5 


equal, not equal 

>, >-greater, greater or equal = 

< p <^less. less or equal 


The following can bo used in window definitions; 

Format <Fmt) ¥ f Dn Floating or fixed decimal point. With D, n 

gives the number of decimal places to be 
displayed. 


313 


VJcwSheet and ViewStore ; A Dabhand Quid? 


R,L 


M, S 


Options (Opi) C 


H 

O 

S 

T 

V 

l f 2 


Right or loft justification of numbers, Text 
labels can only be changed using EHIFT-ffl;, 
the JUSTIFY LABEL function, 

Negative numbers shown with a minus 
sign or within brackets, M is more 
familiar* but B is often used for financial 
calculations. 

Bar chart shows cell contents as row of 
asterisks. 

Horizontal scrolling linked to other 
windows (screen windows only). 

Switch window off. 

Switch left side border off. 

Switch top border off. 

Vertical scrolling linked to other windows 
(screen windows only). 

J lighlight one or two, underline or bold 
(pinter window only). 


ViewSheet Error Messages 

VicwSheet may produce the following error messages. These appear 
normally in Command mode, or in the status area at the tup-left hand 
comer of the screen in Sheet mode. 

Bad file The file is not a ViewSheet file. LOAD can 

only load files saved with the save 
command, and LW only loads sw files. 

Bad heading The heading already exist* elsewhere 

Brackets Brackets must be matched In pairs in 

expressions. 
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{ 


Command? 
Divide by 0 
Edge 

File not found 

F B error 
Log range 
LOOKUP 


Memory 
No file 

Not enough memory 
No sheet 


Out of range 


Overflow 


An invalid command in Command mode. 

The expression involves dividing by zero. 

The model may extend only to row 255, 
column LU. Replication would involve 
cells beyond the Limit. 

Check the spelling of the filename, and 
check the file exists with *CAT. 

Some filing system problem prevents 
WRITE or READ working. 

Logarithms of negative numbers aren't 
possible, 

ViewSheet failed to find a value in the 
compare range. Something must match 
the selection value exactly. Alternatively, 
the result range 1$ shorter than the 
compare range, 

The model has run out of memory. 

The link file can t be found Check that it is 
on the disc, with +cat V; remember it must 
be in directory V. 

The model is too big for the screen mode. 

Probably the sheet has been corrupted by 
an unsafe * command. Type NEW and 
reload the model- 

The number can't be larger than 255. 
Alternatively, the link file has fewer rows 
and columns than specified in Read or 

WRITE, 

The expression is too complex. 
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Propagated 

Ceil reference to a ceil containing an error. 

Protected 

Protection must be switched off before a 
whole row or column can be deleted, or 
before a cell in a protected row or column 
can be edited. 

Range 

Something wrong with a range 
specification. 

Syntax? 

A valid command but with (he wrong 
syntax in Command mode. 

Too big 

The expression uses a number that is more 
than I.7E3S, the largest number ViewSheeE 
can use, 

Too few arguments 

Not enough information supplied to READ, 
write or the conditional functions IF, 
choose and lcoojf. 

Too long 

The longest line VlewSheet can accept Is 

191 characters. 

Too many hies 

Only Hve link files can be used with one 
model, or 10 with adf* 1 . 

-ve root 

SQR must have a positive number 

% 

The value is too large to show in the 
column width using the current format. 

It's shown in full m the status area when 
the cell cursor is on the cell. 

?ErfOr 

Error in the cell contents. The full Error 
message appears in the star us area ivhen 
the cell cursor is cm the coll. 


Getting More Memory 

Running out of memory with ViewSheei 15 a serious problem, as there is 
usually no easy way to simplify an existing model. There are two 
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solutions splitting the model Ln two, or fitting more memory to the 
computer. Splitting the model will usually involve a link file to carry 
values from one half to the other. This h really only feasible if there is a 
natural 'break' in the spreadsheet, $ay between data processing and 
analysis phases of the model. 

Find mg more memory may be the only option The easiest way is to 
change to a less memory-hungry' mode, perhaps mode 7, but this gives a 
very' poor sheet display. With the Master series or the BBC B+, ensure 
the shadow screen is in use by selecting, say, mode 131 or typing: 

*ss ado* 
mop® 3 

This can gain back about 20k of memory for sheets using mode 0 or I6k 
extra in mode 3, Fitting a 20k or 32k shadow ram board to a BBC R gains 
a similar amount. The units from Watford Electronics and Aries are 
recommended. 

The only other way the size of the mode] can be increased is by using a 
6502 second processor or Turbo co-processor, but this adds very little 
memory if shadow ram is already in use, typically only about 4k, There 
is no Hi ViewSheeh However, a Second Processor speed? up 
recalculation of large spreadsheets significantly. 
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ViewStore Command Mode 



The following commands can be used in ViewStore Command mode. 
Minimum abbreviations are shown in brackets—either capitals or 
lower case can be used. 


ESCAPE 


LF <name> 


LIST 


Switches to either Card or Spreadsheet 
mode* providing a database is loaded. 
From either data mode, ESCAPE returns 
to Command mode and saves any 
changes made to the database. 

Loads the specified new format for tlie 
database. The name can be a complete 
filename, or a part-name to which the F 
prefix is added automatically. 

Uses on sown the fieldnames used by the 
database, (LJ). 


LOAD <name> [<name>! Loads the database. A single name can 

specify both data and format files using 
the D and F preli*es, For example, 'LOAD 
CREDIT" could load :0.D.CEEDTT and 
iZ.F.CREDtT. Alternatively, separate 
complete names can be used for the files. 
(L). 


MODE <n> 


NEW 


Changes the screen mode. fML 

Restarts ViewStore. There is never any 
need to save data before typing NEW. 
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PREFIX (<i> cprcfix:>) 

Used to set the fi ve prefix strings - D, F # t, 
S and LT These prefixes are added to 
filenames before loading and saving files. 
PREFIX without parameters displays the 
five current prefixes. (FRE), 

PRINTER <filennme> 

Loads a printer driver. The driver can be 
used to allow the use of highlight or 
special characters in reports,, for 
example. (PR1NTE). 

5F <name> 

Saves the current database format in the 
specified flte, using the F prefix if 
appropriale. 

UTILITY <namc> 

Runs a utility program. The Lf prefix is 
added automatically to the name given. 

UTILITY CONVERT 

Utility to change the order of fields in the 
database, insert more space for records, 
purge deleted records, etc. 

\U CONVERT ), 

UTILITY INDEX 

builds or rebuilds the index file on some 
specified field. [U INDEX X 

UTILITY LINK 

Writes data from the database records to 
a ViewSheet link file. (tl LINK). 

UTILITY MACRO 

Writes data from the database records to 
a view macro file. {Lf MACRO). 

UTILITY REPORT 

Prints or displays a report, if necessary 
using a report definition filc. 

(U REPORT). 

U TILITY SELECT 

Makes a selection file containing just a 
part of the overall database The 
selection file can then be sorted and used 
with most of the other utilities. (U 
SELECT X 
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UTILITY SETUP Utility to set up a fresh database, or 

create a new report definition. 

{U SETUP). 

* STORE Selects View-Store from another 

application. 

All other star command* can be used too, though some may corrupt the 
format file in memory,, and reloading the database may be necessary. 
These dangerous commands include; *HACKUP r *CGMFACT, *COFY, 
*KOtiMAT, *LGAD, #5RLOAP (using Q) and *SM£AVE (using Q), However, 
the database should not be vulnerable, as all the data is saved on disc 
before returning to Command mode. 


ViewSlore Error Messages 

ViewStore may produce the following error messages, either in 
Command mode, or Data mode. In Card or Spreadsheet mode, the 
error message is displayed In the status area of the semen at the upper 
left comer. 


Bad date 


Bad directory 


Bad drive 


Bad expression 


Bad field 


The date doesn't match the dd/mm/yy 
form required (miti /dd/yy for American 
dates), or the day of the month doesn't 
exist (for example 31 /9/S7). 

ViewStore expects files to be in the 
correct directory, for example format 
files in the F directory. Check the prefixes 
are correct for each type of file. 

Usually this means a dot left off the end 
of a prefix string, eg, TfcBFDt D 

An invalid expression in a report 
definition. Check the list of database 
field names, and also that there are 
delimiters around all names containing 
wildcards In the report field list. 

The field doesn't exist. Try LET to check 
all the fieldnames. 
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( 


( 

Bad FS 

ViewStore doesn't work with tape. 


Bad macro 

Only two letter names are possible. 

c 

Bad mode 

Mode requires a sensible number 

< 

Bad name 

The filename isn't valid. Check the 
prefixes all end in a dot. 


Bad pointer 

The index file needs rebuilding, 

( 

Bad prefix 

Only D, F f 1, S and U prefixes can be set. 

( 

Bad record size 

Record size requires 3 sensible number, 
possibly with a +, 

( 

Bad register 

Only A: to 2: are available. R: and P: 
shouldn't be used as they are reserved for 
the record and page numbers. 

( 

Bad selection 

Selections must consist of fieldnames, 
operators and values. The valid 
operators include brackets, and and oh. 

( 

Bad string 

The index name In the database format Is 
invalid. 

< 

Brackets 

Brackets must be balanced in expressions. 

Can't extend 

A file has grown too big. 

( 

Channel 

Go to Command mode, type new and 
reload the database- 


Data screen only 

spreadsheet or Card mode only. 


Disc full 

A file has grown too big. 

( 

Divide by 0 

The REPORT definition contains an 
expression that involves dividing by zero. 
This is commonly due to dividing by a 
numeric field which is left blank for some 
records. 


C 
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Editing no file 

End 

Escape 

Field is not numeric 

Held not found 

File crisis 

File more than 
File not wide enough 
Filename not found 

FUe not open 

File open 
Fixed format 

Index; bad Fdename 


Load a database before leaving 
Command mode. 

The beginning or the end of the database. 
Escape. 

I INK files* can only carry numerical 
information. 

The field doesn't exist. Try let to check 
the current fieldnames. 

Files of the same name already exist. 
Either delete the existing format and 
data files, or pick a new name far the new 
database to setup 

The link file is beyond the maximum size 
possible. 

Not enough columns in the link file for the 
number of fields used, 

ViewStore can t find the file. This may be 
because it doesn't exist, or because the 
prefix is causing ViewStore to look in the 
wrong directory or on the wrong drive. 

A file can't be opened. Return to 
Command mode and reload the 
database. 

A file has been left open. Try typing NEW 
or *CLQ5E, then reload the database. 

The report definition format file is 
normally un-editable. 

The index filename in the record format is 
invalid- Mao check the T prefix is correct. 
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In ties: file rial open 

The Index file doesn't exist or the 1 prefix 
is wrong. 

Index: can't extend 

The index file doesn't have any room to 
grow nn the disc. It must be deleted then 
rebuilt using the iNDfiX utility. 

Index: not found 

ViewStore can't find Ihe index file. Check 
the name in the database. 

Key too long 

The sorting criteria are too complex. 

Keysize should be... 

Use a reasonable key width for the index. 

Locked 

The database and format files should not 
be locked. Unlock them with * access, 
and try again. 

Limit error 

The value is outside the specified limits. 

Maximum is 4/9 indexes 

There can only be four updateable index 
files with dps and Network, or nine with 
An>FS- Remember some can be made read¬ 
only by putting R instead of Y in the 
record format. 

Memory full 

The utility needs more memory. Change 
to a lower resolution mode; in most cases 
mode 6 is adequate, extreme eases may 
need mode?. 

Mistake 

An invalid command In Command mode. 

Mo data 

Probably the database in memory has 
been corrupted by an unsafe star 
command - type NEW and reload the 
database. 

No database loaded 

All the utilities need the database loaded 
first (except for setup). 

No end marker 

The database file is corrupt- Make a copy 
of Ihe back-up file and use that. If there is 
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no backup, then the IMPORT utility utay be 
able to read most or ail of the file. 


No fields. 

At least one field must have a name 
before Using Card mode. 

No fields found 

The printer width must be larger than the 
width of the first field- Either reduce the 
width of the held, or specify a wider 
printer width 

No index 

V or R (for updateable or readonly), 
must be set in the database format for the 
field. 

No index field 

There are no indexes - the database can 
only be sorted by entry. 

No records found 

The selection criteria are not met by any 
fields in the database. 

Not enough fields 

There are too few patterns in Half I and 
Half2 to match the number of items in the 
field Ust. 

Not numeric 

Numeric fields can only hold numbers. 

Overflow 

A number or result in an expression is 
either too big or too small. 

Read error 

The file is corrupt. Make a copy of the 
back-up of the file, and use that. If using 
a floppy disc, treat it as suspect, and copy 
the database onto a more reliable disc. 

Record too big 

Viewfitore can't read Lhe next record 
because there isn't enough memory left. 
Change to a more frugal screen mode to 
increase the free space, or reduce the 
capacity figure in the database header. 

Sheet display 

Card mode only. 
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Stack overflow 

The expression is too complex. This also 
occurs with the index utility, when 
building an index for a field which is 
already sorted. Make sure the selection 
file is unsorted before using it with index. 

Too long 

A filename can't be more than 12 
characters This can be a problem with 
ADF5 - either use a different prefix, or use 
wildcards in the filename, for example 
'VSTi.CBIDm 

Too many files 

There can only be lour updateable index 
files with dps and network, or nine with 
ADPS. 

Too many places 

The precision is limited to the number of 
decimal places specified in the record 
format. 

Type mismatch 

Arithmetic can only be performed on 
numeric data. 

Value not in list 

The value is not in the value list. 
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Can't Extend 

With ms, when a data or index file grows loo big r space must be cleared 
for it to grow. This can be done with the following procedure: return to 
ViewStore Command mode,, and copy the file on to a spare disc. Delete 
it from the original disc, then compact that disc, Mow copy the Hie back 
from the spore disc. 

This places the file at the end of the disc, where is has the maximum 
space to grow, However, having two growing files on the same drive is 
very tedious When setting up the database, always reserve lots of 
room for the index hies, as they will always be on the same drive. If at 
all possible, arrange the prefixes so that the data Hie is on a drive of its 
own. 

Extra Memory 

ViewStare does not need vast amounts of space to keep the entire data 
file in memory, but it does need to bold the entire format file,, plus any 
utility program, plus one or more records, With the REPORT utility, it 
may need to hold the report definition file in memory too With large 
records, and complex formats,, this may strain the memory capacity of a 
BBC model B in high-resolution modes (0 or 3), Switching to mode 6 
before vising a utility program is usually enough, but if 'Record too big r 
errors recur, extra memory may be needed. 

With the Master series, working in a shadow mode will free an extra 
16k of memory in mode 3. Using mode 131, or typing *$haOOW before 
changing mode accomplishes this, On a BBC B, a shadow RAM board can 
offer the same. Using a 6502 second processor or Turbo Coprocessor 
offers enough extra memory for all practical purposes, a further 4k or 
so in machines with shadow RAM. or about 24k in an original model B. 
The extra memory often allows the capacity figure to be increased 
substantially, perhaps to its maximum, 50, This speeds things up 
because more records are held in memory at one time. 

The second processor doesn't speed up ViewStore very much, because 
its speed is limited by the speed of getting data from disc. Using APTB 
and a hard disc makes a much greater improvement in ViewStore's 
perfornumee, because the data transfer is much speedier. 
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Appendix C 

ViewPlot Quick Reference 



Elements o£ the ViewPJot system may produce the following error 
message*. They may be displayed by the data editor, the format editor, 
the graph plotter or the pattern editor modules. 


Data set not found 


The data editor load command can't 
load a Ole that doesn't exist. Make sure 
the correct data disc is in the drive. In 
graph plotter, check filename in format 
file is coned. 


D/F file not found The graph plotter can't find the specified 

file Check the correct disc is in the drive 
and the filename is correct. 


File not a data set 


The file must have been saved by the data 
editor. 


File not a pattern file File must have been saved by the pattern 

editor. 

File not a forma! file File must have been saved by the format 

editor. 


Format fUe not found 


GXR active 


Link file not found 


The format file doesn't exist. Make sure 
the correct disc is in the drive, and that 
the filename given is correct. 

The Graphics Extension ROM is active on 
a model B or &+. Press BREAK and start 
again. 

ViewPlot can't find the specified V,VS link 
file. 


( 


Negative Y data in pie Pie charts can only plot positive values 
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Not a link file 


Pattern file not found 


Pic sum too small 


The file is not it valid link file. Link files 
can be created only by ViowSheet's 
CREATE command, by the ViewStore LINK 
utility, and by special programs like the 
enhanced rwunk utility on the disc 
accompanying this book. 

Pattern editor can't find the pattern file * 
make sore the filename is correct and the 
right disc is in the drive, 

Y values are too small for accuracy. 


Spool file not found 


This is not a D/F file 


This is not a F Hie 


Check the filename is correct, the same 
given with *spoou *preparf or to the 
ASCII spooler 

The graph plotter can use only data and 
format files saved by the data editor and 
the format editor. 

The next chained format is not a valid 
format file. 


; 

; 

> 
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Appendix D 

OverView Star Commands 
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The following star commands can be used if OverView is present. 


fcKFEP [GN T ,OFF,RAM,QUIET, <prefix>] 


Switches the Keeper on or off, using disc 
storage for the context files. It can also 
be u^d to set a prefix for the context files. 
♦KEEP RAM makes OverView use the four 
banks of sideways ram in a Master 12B to 
store two complete contexts, reverting to 
disc for subsequent files, *keep quiwi 
temporarily disables the Keeper. *keep 
alone displays the current Keeper status. 

*Rt <filcname> Reads a ViewSheet 'contents' file into 

another ViewSheet model. This way it 
allows transfer of large amounts of data 
from erne model to another. 

sfcREAD <filename> <cell> IT] 

Reads a correctly formatted text file into 
a ViewSheet model, beginning at the 
specified cell The text could be produced 
by VIEW or even a ViewStore report. 

WIDE fON,OFF] Switches the wide screen system on or 

off. This gives 106 or 53 characters in 
screen modes normally showing, only 80 
or 40 characters. The wide screen works 
only in two-colour modes (0,3,4 or 6 plus 
their shadow equivalents). 


f 


C 

329 

f 















VfcwSheet and VlewStpie ; A Dabhand Guide 

OverView Errors 

The following error messages are associated with the OverView star 

commands. 

Bad syntax Wrong syntax for a OverView command. 

No page OverView requires a Master series 

micro. 

Not found OverView can t open the file. Use *cat 

to check the file exists, and +KEEP to check 
the context file prefix, 

) 

Too much to keep With a Master Turbo or 6502 second 

processor, a VIEW document longer lhan 
3flk can't be saved in a context file. Save 
it normal!y and use frKEEF QUIET to disable 
the Keeper 
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Appendix £ 

ViewSheet and ViewStore 
Programs Disc 



A disc of software is available to accompany this book from Dabs Press. 
It contains all the programs listed in this book, plus a number of new 
utilities for Vieu*heet and ViewStore users and many of the major 
example models and databases: 

VSXFER and ASCII spoolers for the VIEW family 

JOIN, PURGE and MULTiMACRO utilities for ViewStore 

PACE on-screen page previewer 

SIDmtr prints Earge spreadsheets sideways 

rwunk enhanced Basic link file handler 

DECODE exec tile decoder plus selection of exec files 

•close uf slity 

•PATCH utility 

fflOQT files for ViewSfore and ViewSheet 
beach and invoice mod efs 
BiBiiOC and members databases 

•CLOSE is a utility for nF$ users with bbc model B micros. Sometimes, 
files are left open, for example when BREAK is pressed. Files left open 
can't be deleted or modified The BBC B+ and Master series micros 
provide a •close command to shut all open files. This utility does the 
same on a normal bbc b. 

•BATCH makes exec files more intelligent. It allows exec files to contain 
patterns, %1 to %% These can be replaced by arguments as the file is 
being read. So an exec file called 'RELEASE' could include: 

-copy :ti si ti 
-DELETE S0.11 
«COMPACT :D 

"■cop if si iD %i 

This exec file carries out the procedure described in Appendix Two for 
releasing extra room on a disc to allow a file to grow after a 'Can't 
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extend" error. Clearly, %1 represents the name Ole of the file to be 
released, so: 

*BATCH RELEASE D.COSTOM 

releases a file called DCL'STOM r . Any file can be released simply by 
supplying its name in the *BATCH command. This way, exec fries can 
become totally general purpose. 

The disc Is available for the BBC n,B+ and Master 128 micros on a 5.25- 
inch 4G-traek disc in DFS format- El you have an fiO-track disc drive, a 
copy program converts the disc to 80-tmck format The software is also 
available on an ADffi 3.5-inch disc for Electron, Master Compact. 
Archimedes and other ADFS users The disc is unprotected, and the files 
can easily be transferred to hard disc or network fileserven It is 
supplied in a wallet, complete with full instuctions for a cost of £7-95 
[5-25dnch) or £995 (3.25-inch), inclusive of VAT, postage and packing. 
Please add £2-00 surface, or £6.00 air mail for orders outside the UK or 
ilFPO 

To obtain your copy of the disc, fill in the order form below, and a copy, 
or just write a letter. Send it and a cheque, postal order, sterling money 
order, {or official/company/government purchase order) or your Access 
or Visa number to Dabs Press at the address on page ii. Telephone 
credit card orders are also accepted - 


Please rush me a copy of the ViewSheet and ViewStpre: A Dabhand 
Guide Programs Disc, 1 enclose £. for a 5.25" J / 3.5* version. 


Name,.™.™*,™.**.*. ■ ■■■■«■ ■ « *■ ■ ■ + ■.■ ■ ■■■■ ■ am a ■ ■■■■■■■■■ ■ mmn ■ ■ ■■ ■ ■ ■ ■ r ■-a -b ■-r-i ■ a ■ rtTiiir + il HbVl 

Address. ■ Til ■■*■■■«•■■ b-fb ■■Tirrra a pb-tb p pb b ■t--fft ! i bp- ■ t*4 ■*<«*- ■ P Pa ! P4 ■ ■ ■- ■ ■ P-P" ■ si.-bb.<ibbbibbbbbbbbibbbib 


in b iifi a ■ pi i 


pTB«fp* i HtiP l 'i ni l ** a 


hum mr-rnm m immiI^H b - - pH- P « + * 


Tick here if you require a vat receipt... 
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Appendix F 

i Dabhand Guides Guide 


The following books and software packs covering the BBC and Master 
series micros are published or planned for Leaflets are available 
on all products which go into considerably more detail than space here 
permits. Publication dates and contents may change, All quoted prices 
are inclusive of VAT (on software—books are zero-ratedb and UK post* * 
age and packing. {Abroad add £2 or £10 airmail). All are available from 
your local dealer or in case of difficulty direct from Dabs Press. 

VIEW: A Dabhand Guide by Bruce Smith 

(SUN 1 870336-00-3 A vailable Now. 256pp. Book: £12 95. Disc: 5.25fn 
I £7,95,3.5in £9 95. Book and disc together £17.95 (ADFS £19,95} 

This is the most comprehensive tutorial and reference guide written 
about using Ebe VIEW word processor, A suite of VIEW utility programs 
( are provided including VIEW Manager, an extendable front end. An ex¬ 

cellent companion to View Sheet ami ViewStvrt; A Dabhand Guide. 

Master Opera ling System: A Dabhaud Guide by David Atherton 

* tSBN I-S70336-01-1 Available Now. 272pp, Book £12.95 5.25 J disc £7.95 

3.5" disc £9.95 Book/disc £17.95 (3.5" £19,95) 

Acclaimed reference guide for programmers and users of the bbc b+ and 
i Master Series micros. Contains a wealth of information on the Pperat 

mg System, including all star commands, Q5BYTE and CSwOrd calls, the 
Tube, filing systems, the non-volatile RAM, differences between ail BBC 
[ machines and much much more. 

Master 512: A Dabhand Guide by Chris Snee 

ISBN 1^70336-14-3 

Publication: May 1988. 256 pages approx. Book: £14.95 Disc £9.95 

Contains all that you are likely to want to know about your Master 51 2 
serving as a tutorial and reference guide 

Bumper Assembler Bundle by Bruce Smith 

Publication : Available NowJ books, 2 discs and booklet: Just £9.95 

, Five-part package of assembly language materials at Jess than a third 

of their normal price. Full details of pickage on request. 
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Archimedes Assembly Language; A Dab hand Guide 
by Mike Ginns 

ISBN 1-870336-20-3 Publication: June 1988 350pp approx. 

Book : £14.95, 3,5" disc: £9.95 Book/disc £21.95 

Archimedes Operating System: A Dab hand Guide 
By Alex and Nick van Someren 

ISBN: 1-S70336-48-S (Programs disc 1-870336^9-6* Available July 1988 
250 pages approx. Price: £14-95. 35" disc: £9.95 Book/disc £21,95 

C : A Dabhand Guide by Mark Burgess 

ISBN 1-870336-16-X (Programs Disc 1-870336-22-4) Available April 
1988 500pp approx. Price: £14.95 3-5" disc £9.95 Book/disc £21.95 

With sections specific to Archimedes and Master Cs, 

BBC and Master Software Packs 

View Executive by Graham Bell 

Available September 1988 Software pack on disc. Price £19.95. 
(formerly View Family Utilities) 

This package for VIEW, ViewSheet and VfewStore users contains a host 
of useful utilities designed to enhance the power of the suite. Contains 
two discs and 100-page manual. 

HyperDriver by Robin Burton 

Available now rqm £29.95 Sideways RAM version £24 95 

The ultimate printer RDM including: on-screen preview, CRT graphics, 
ML Q font, user definable macros, and 80 * commands to control your 
printer attributes in plain English. Compatible with VIEW family- In¬ 
cludes 100 page manual and demo files. 

Fingerprint by David Spencer 

Publication : Available Now 5.25” disc £9.95,3-5" disc £11 95 

FingerPrint is a singles tep machine code tracing program. It allows 
you to step through machine code written by yourselfi or part of a com¬ 
mercial program. Includes disassembler/memory editor. 

MOS Plus by David Spencer 

Available now ROM £12-95, Disc for Sideways ram £7.95 (3.5" £9.95) 

The rom for all Master 128 users (only) providing adfs VORMAT, VERI¬ 
FY , ’BACKUP, *CATALL and *EXALL ancf several new t.ommands- 
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SideWriter by Mike Ginns 

Publication: Available now 5-25" disc£7-95,3.5" €935 

For Sideways ram owners find Masters), a pop-up notepad which can 
be used front any program. 

Conversion Kit by Bruce Smith 

ISBN 1-870336-0&-2 Available now. 5 25" disc £7 95 / 3-5" £9-95 

A disc containing 24 expert routines that you can use in your own pro¬ 
grams. Each routine is held within a basEC and assembler program as a 
procedure that demonstrates how to use it. 

Master Emulation ROM by David Spencer 

ISBN I'870336-23-2 Available now ROM £1995 {Disc for sit AM £1495) 

Tbi-S new som software is especially for Model B and B-i- owners, and 
provides you with most of the features of the Master 128- 

Other Books from Dabs Press: 

Amiga DOB: A Dab hand Guide by Mark Burgess 

ISBN bS7B33647-X Publication - July 1988- 300 pp. Prices £14-95 

WordStar 1512; A Dabhand Guide by Bruce Smith 
Including WordStar Express 

ISBN 1-870336-17-6 Publication : June 1968, 260 pp Book: £12.95, Disc: 
£7.95 Book and disc £17.95 

PCW 9512: A Dab han d Guide by John Atherton 

ISBN 1-870336’50-X. Publication : Late 1988. 300 pages approx. 

WordPerfect: A Dab hand Guide by Bmee Smith 

ISBN 1-670336-53-4, Publication ; Early 1969, 350 pages approx. 

Ventura Publisher A Dabhand Guide: Simon Williams 

ISBN 14570336-52-6. Publication : Early 1969. 300 pages approx, 

PostScript: A Dabhand Guide by Paul Martin 

ISBN 1-870336-54-2- Publication : Early 1989 300 pages approx. 

NE; All future publications are in an advanced state of preparation. 
Content lists serve as a guide but we reserve the right to alter and adapt 
them without notification. If you'd like more information about our 
books and software then drop us a line at the address on page iL 
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absolute replication ,, IM5 

arcmmtft,.. 48 

ACS., Si 

activecell ..9-10 

adding field* „. 25+4 

alphanumeric field . . 119-21J39 

amcrican data field ... 139 

AND. ■ I 3 ?^yzi 5 

archive.., 95,133 

iUTiv hie . 22.3 

ascii code.. 74 5 

ASCH spcoter. . 83-3^03*206*2*5 
ASN .221 
ATN-221 
auto-boot 191,241 
automation... 258-9 
AUTO ENTRY , 44 
able line feed 76-9,204 
AVERAGE 30,42-7,214 
mdsbhefc ■ 295 

backing up... 148 
barchart 2IIUB6-S 
Hast t... 166,228 
baud late „* 19,140 
BEGINNING OF FIELD ..97 
BEGINNING OF LINE 12 

bold ., 73.77-9.363 
boot option 241 
border width .. 2731,49,54 
BotR.St 
brackets... 25-7437 
budget fL-iriva^s ■ 46 
BW, wt border width 

C r see bar chart 
GalcutatUHU, In reports ..ISO 
On'l extend ., El 4,173,250326 
capacity... 124 

CAFS LOCK.241 

raid djspL-w .... 126 
CARD LAYOUT 127 
caid layout 242.257 
aid mode , 93-5 



carousel ... 294 
cell ... 9,92 

celt contents .. 10,205 
editing... 11 
cell cursor ,..9 
ceflfdnmt .. 25 7,258 
cell refenmee .13 
circular ... 25 
dincLton t*! 

CHANGE rifepLAV . 93^124427 
character cursor 96 
character tot... 197 
CHOOSE .215319 20^233 
choosing records ... 133-5 
coding- 154 

CwMcierl of variation ... 42-4? 
COL... 29,214 
colour . 59*60,129-30 
in boat fifes... 2fl2 
columns ,..9 

COLUMN HEADING ... 3M 
column headings . 31*2 
column spwring ... 52 
column width ... 26,49,54,218 
command file ... 25S 
command mode... 90 
command screen M .fl 
comment line ... 197-8,364,271 
comment responds 188 
compatibility 5 
Cunxlciised print , 197,193,196 
conditional functions .. 21:5.221 
consolidation ... 226 
constants ... II 
contents file . 303-4 
context 51a -■ 300-1 
in RAM 301 
control codes r.a 72*5 
CONVERTutility ... lGS-^ES&Zft 

ax...221 
CREATE... 223*7 
CURSOR LOCK . 254 
CW, see column width 
C type ,187 
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D r see decimal places 
DATA. iZH 
database,. 95,133 
cUtatastHJt. .91*113 
DATABASE HEADER m 
database header . 117,123-5 
database manager... B9 
data editor, VIcwFUM 
data entry ... 154 
ditafleU -- 121 
data tnude . «1 
DMA Fmtortkm Act . 1*9,243 
data security .. 242 
ddUH1dd-*U9 
dectamJ places 120 
DECODE prtgrAcn. .195-202.2*1 
DEG... 221 
degree .194 
degrees 221 
deleted records 163 
DELETE CHARACTER... 97 
DELETE COLUMN... 41 
DELETE END OF FIELD. 246 
DELETE ENDOF UNI, 11 
DELETE ROW 41 
DELETE SLOT .1250 
deleting mcnb--- 163 
DC* s-witchw 76-8 
directories 18,108-12.117,299 
iltKspane - H3-l54niW 
display mode... 124 

ridW. ,.77 H 140mW 

dauhta spacing . . 78 
dummy comment... 264^5 
dummy 5cEd ... 129.155.245 
dummy register... 265 

ediling holds - 97 

Edit tine ... ID-16 

EDIT SLOT FORMAT ... 25 

EDIT WINDOW . ZMOrSS 

tflectrorilE mall... 03 

encryption ... 242 

end of data marker ... 166249 

END OF FIELD... 97 

END OF LINE . 12 

entry... 100-2 

error ifurfsaget ... 239 

Escape sequent ... 75 

exec file... 191,194.241,258-9 

EXP... 222 

exponent notation ri-fcfr 12 


extended highlights ,,, 266 
extra memory . 316,3,26 

F REPORT 172 
false ... 27,217-0 
field 

cursor ...94M 
Hat. .174-6 
name .92,118 
oiicier ... I I0 r 163-d 

file organiSa-tiftR . . 109-1fl 
fixed format . .. 257 
fklEDe +t ,8S 

Fmt, see number formal 
formal editor. View Plot . 294 
formal file ... 91J 13,125.243-1 
editing 256-7 
loading . . 257 
formula ... ID. 13 

form length 200 
functUana .., 28 
funetbon keys .., 259 

GO TO SLOT . , 8,1032 
graphs... 285 
gPOUP fnfiutttty ... 216 
gsrand 199-201 
GXJ1L. 6167 

H, see horizontal scrptttng 
H tvpe . 175 
mn 174-5,107-8 
Hi LE ,174^,386-7 

haid copy .. 50 
hash ... 77,140,JW,197 
bmdtrttwa 175 
HEADINGS.. 32 

highlights ... »^1HW 
extended --. 7H 
in file .. 83 
high limit.. 121 
histogram ... 210,288 
horizontal scrolling ... 57 

EF . 2157 

Importing databases . .. 234 
importing report file ... 269 
IMPORT utility . 252-3^57^69 
index .. tOO 
Index by entry 126 
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DMD0CFIELP--100-1,132 
Index skid, In header 124 
index Tile .. 120 
index name... 122 
INDEX inIIMy ,.130,165,250 
indexes . 115,120 
binbding ... 131 
arwli™ ... 121 
number of 115 
rtodcmW 114,121,131 
rebuilding.. 130-2^50 
updateable . 114,121,130 
INSERT CHAP A CTE1? .. 8/97 
INSERT COLUMN ,41 
INSERT ROW .. 40-1 
INI - -. 222,133 
invoices ... 232-5 
italics... 72,77 

JOIN program 24S-51 
joining databases.-, 247-i 
JUSTIFY LABEL ... 1536 

keeper . . 299-301 
key size .1154 
key width- -120J&4 

labd . 10 

Label alignment... 104 
LAB EL utility ^ 102-5.133,1 46J6L25S 
fcvbdi ... 102 
LF. 244-7 
Limits.. 121 
I in* graph - 3S4-S 
line length, VIEW 252,272 
line type ... 174 
link fite 22.1-7 
ViewPifirt . 2901 
with Basic . 223 
with ViewStore - 229 
LINK utility ... 229-30 
LIST . 134,158 
lists. .21? 

size of... 214 
LN .. 222 

LDAP... 2058-9.9 1,11 7A7&M 
luiul formal file, see LF 
Load windo w dcfinllaiis, see LW 
LOCATE -- 101 -2.106-7,1 62 
IttCkttl fifes ... 244 
LOG •• 1,1.222 

Icigadtlnnbc functions . 222 


LOOKUP 215220-1033 
low limit... 121 
LW „ 58-9202 

M type, 175 
macro... 15fr-9 

definition file ... 161 
file -276 

MACRO utility .,. 156-61,272,278 
miiiling Li hi 150 
maalnnefging .,. 160 
mailshots-, 156*159^70-2 
main ruot directory .. 73 
map... 291 
margins ... 80 
mask fife.*. 47,227,235-9 
MAX... 3H 

merging sheet mid text ,. 237 
MIN... 30214 
MODE... SW'WQQ 
model 17 

mullt-iTuvcrn ... 272-4 
multiple charts ... 294-5 

NAME .20 
nesfi ng IFs M* 215 
NEW ... 20,111 

new database, celling up .. 113 
new record, adding 98 
NEXT WINDOW ... S5-8 

NL...Ql9flr9 

tvot enough fields .. 179 
number format ... 25-6,37-9.49,186,238 
NUMBER OF CHARTS 295 
numeric field . . X 19^21 

OLD -30 
operators . 27 

condilioTial ■ 28 

precedence ... 27-8 
opt ions .- 54 
OR. ..1374215 


page eject, in report , 271 
page Layout B0Ll74j89j2CHFT 
FACE previewer ... 63-7 


page regisltf 176-7 
paper size .. 66 
poUirm 156J 75-9,186 
payroll... 2-15-7 
PC -2EM30M 


perfcinrtkm skip . 2Efi 
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n.,.m 

trie chan... 2fjxs 

planning . 
pototfng 16-7 
h».. 54 

(Untlkl . 77.1«im IV 
precedence , 137 
hUsttX 11U45 
prefi*172 

prefixes ..in 2,117,134,24 J*3C&£ 

print 

PRINTER ... 64-5733,140 
prurient.. 19 

printer character sets . 77 
prin ter driver.. 64,7*140 
punterdriverr generator ... 74-fl.l93J66 
prlnler LnElriaEisatJon 75 b 

printer Hfacttan .. 2116 
prim l*i width . . 140 
primer window , 50,61,194,235 
prompt 122 

proportional sown dump . 290 
PROTECT . 55 A l 
PROTECT COLUMN XI 
PROTECT ROW .... 32-3 
PRTDUMF ... 2fl5-90 
PURGE program165,2^1 
Ptype. 174 

qurtu., 133 

RAD ,221 

met tans .. 221 

range .. 143 
READ,., 225-6,230 
RECALCULATE ,.46 
recalculation . . 15.2X4&228 
direction ... 23 

RECALCULATION MODE. 46223 

retard . . 8& r 92 

record format.. 117-22*246 

record UfW... 175J271 

rEcmd. register I7M4 

record size .. 124-5,165 

record space .. 163 

record C&D big 124 

registers,.. 176,10Q’3 

relmforul database 88 

relatl ve replication 16-7,45 

REPLICATE -.15 

replication .,, 33-5 

report definition! file... 147.172-4 


compacting.. 27D 
report file,editing ... 267 
size. .269 

REPORT utility . . 146—8,172*230- 2JE63 

ROM priority - - 8 

rounding - ■■ 26,238 

ROW . 13,29,214 

rows...9 

how heading ... 3o 

row heading!* 3X2 

R type 175-6 

S, see scroll 
$, see side bolder 
Slype IK 
S.SkTINT 145 
SAVE... 18,20,4058-9 
ft »vt format, see SF 
save window, we 5W 
SCREEN ,. 624J35 
screen designer 1217-9 
SCREEN DUMP , . 289 
screen mode . 124,130 
SCREEN PRINT 289 
screen window, see windo w 
scroll... m 

selection.133,143 

criteria 135-137 
Rle. 134 
file... 141-2 

SELECT uliUty 13X5,151 

serial number 25b-7,277 

SETUP utility . 113-6,120,17X5,243 

SF-.24X7 

SGN. .222 

SHEETS ..64 

sJicet screen . 8 

StDEPRT program . 20X5 

sideways printing... 303 

sadoways ROM .... 7,89 

sade border .,.-.55.6] 

SIN ... 13,221 
site licence . . 8,89 
slot -9 

fttwill miitbyroatical errors ... 258 
sorting ,141,144,146 
sort field ... 943 
■ 98 

spuci* for fta — 112 
spooler . &1-2 
spreadsheet capacity .., 10 
spreadsheet mode ... 92-5,126,242 
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SQK...2M422 
square root 

,M + 222 

Standard devi-irinn ■ ■ ! 42* 
stslknery size . 1+7,174 
subscript .. 77 
subtotal liTH?.. m-223Q-2 
subtotal trigger ,.-183 
SUM,. 10940 
superecript ., 77 
5W 58-63,219 

T, sci. 1 tktd type 
T. see Line type 
T, sw top border 
TAN ...m 

ie*t field . llM2] f T39 r lS+ 
le*t file, Vtfwflql ...292-3 
title 123 

too much to keep ... 302 
Tcrp U,... 5+ 
lop bcifdor. 55/fcl 
IoLiL line .. 1B1-X230 
transfer to VIEW .. .. Hfl 
CriftarKimi.-trlc functions 221 
hue 27*217+5 
typo mismatch ... 180 
f type182 

underline... 77-9,263 
user name . 110 
user root fflr t tl a i y... 73 
utility disc .. 103,109 

V r see vertical icrolltng 
V.VSn... 223-7 
value -■! - iaii 
value list... 122.154 
variance... 43 r 46 
van leal scrolling ... 5* 

ViewChart ... 296 

View line length .. 1*2 
VSM ACftO program .. '273-P 
VfiXKER spooler . 81,188300206 

WTD, Me field width 
Widescreen ... 302 
wide spreadsheets ... 193 r t% 
wfkk&nl . 1+2,151,255 
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This book is □ complete tutorial and reference guide for the 
ViewSheet spreadsheet and the ViewSlore database manager. 
It is specifically written to appeal both to Ihe beginner and to 
the more experienced user, whether you wish to check your 
bank statement or run a million pound business. Every ospecl 
of selling up and using a database or spreadsheet is 
described in detail, and numerous examples are provided to 
guide you. There are also a number of utility programs to help 
you gel more oul of the VIEW family, including programs fhot 
join two databases together ond help Iransfer spreadsheets 
into a word process or. OverView and ViewPlot are also exam¬ 
ined and explained The many features of this book include: 

• Compatible with BBC B and Master Series 

• Usable with DFS, ADfS and network 

• Simple spreadsheet and databases 

• Absolute ond relative replication 

• Building an invoice system 

• Oatabasedesign 

• Use of SELECT ond REPORT 

• Using o printer 

• Hints and Tips 

A OverView a nd ViewPlot 

Graham Bell is Technical Editor of Acorn User magazine, and 
a respected authority on \he BBC Micro. An expert an the VIEW 
family, he has written numerous articles an the use of VIEW, 
ViewSheel and ViewSlore, Formerly he was a student at Ox¬ 
ford University where he graduated in Geography and spent a 
further four years undertaking research at Reading University. 
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